For the operation of i-doit we recommend the use of Debian GNU/Linux in Version 11 "bullseye" as operating system.
In this article we explain in just a few steps which packages need to be installed and configured.
The general system requirements apply.
This article refers to Debian GNU/Linux 11 "bullseye". You can find differing installation instructions for version 8 "jessie" in the text below. In order to find out which version is used you can carry out the following command:
As system architecture you should use a x86 in 64bit:
x86_64 means 64bit,
i686 only 32bit.
Installation of the Packages
The default package repositories of Debian GNU/Linux already supply the necessary packages to install:
- the Apache web server 2.4
- the script language PHP 7.4
- the database management system MariaDB 10.5 and
- the caching server memcached
The installed packages for Apache web server, PHP and MariaDB already supply configuration files. It is recommended to save changed settings in separate files instead of adjusting the already existing configuration files. Otherwise, any differences to the existing files would be pointed out or even overwritten during each package upgrade. The settings of the default configuration are supplemented or overwritten by user-defined settings.
First of all, a new file is created and filled with the required settings:
This file has the following contents:
The value (in seconds) of
session.gc_maxlifetime should be the same or greater than the
Session Timeout in the system settings of i-doit.
date.timezone parameter should be adjusted to the local time zone (see List of supported time zones).
Afterwards, the required PHP modules are activated and the Apache web server is restarted:
The default VHost is deactivated and a new one is created:
The new VHost configuration is saved in this file:
i-doit includes differing Apache settings in files with the name
.htaccess. The setting
AllowOverride All is required so that these settings are taken into account.
With the next step you activate the new VHost and the necessary Apache module
rewrite and the Apache web server is restarted:
Only a few steps are necessary to guarantee that MariaDB provides a good performance and safe operation. However, you should pay meticulous attention to details and carry out these steps precisely. This starts with a secure installation and you should follow the recommendations accordingly. The
root user should receive a secure password:
Activate the MariaDB shell so that i-doit is enabled to apply the
root user during setup:
Password for MariaDB root user
If the MariaDB root user does not have a password yet, the database access will not work after executing the ALTER USER statement. Therefore, the MariaDB root user should be assigned a password beforehand:
The following SQL statements are now carried out in the MariaDB shell (The 'password' must be replaced by the current password of the 'root' user):
Use of MariaDB 10.3 and downwards
Up to MariaDB version 10.3, the UPDATE statement is supported in the user table.
Afterwards, MariaDB is stopped. Now it is important to move files which are not required, otherwise the result would be a significant loss of performance:
A new file is created for the deviating settings:
This file contains the new configuration settings. For an optimal performance you should adapt these settings to the (virtual) hardware:
Finally, MariaDB is started:
Now the operating system is prepared and i-doit can be installed.
Proceed with Setup …
Debian GNU/Linux 8 "jessie"
If you use version 8 "jessie", there are some things to be observed. This especially includes differing package names and file paths.