Installation and Maintenance

apt update
apt update zip unzip openjdk-17-jdk maven ffmpeg git ghostscript nodejs npm

gd, dom, xsl, pdo, pdo_mysql, curl, json, simplexml, libxml, xml, zip, imagick, mbstring

apt install apache2 libapache2-mod-php php php-gd php-xsl php-imagick php-curl php-mysql php-xmlrpc php-soap php-ldap composer

mkdir /var/www/ilias
mkdir /var/www/files
mkdir /var/www/logs
mkdir /var/www/config
mkdir /var/www/.npm
chown www-data:www-data /var/www/ilias
chown www-data:www-data /var/www/files
chown www-data:www-data /var/www/logs
chown www-data:www-data /var/www/.npm

<VirtualHost *:80>
    ServerAdmin webmaster@example.com

    DocumentRoot /var/www/ilias/public/
    <Directory /var/www/ilias/>
        Options +FollowSymLinks -Indexes
        AllowOverride All
        Require all granted
    </Directory>

    # Possible values include: debug, info, notice, warn, error, crit,
    # alert, emerg.
    LogLevel warn

    ErrorLog /var/log/apache2/error.log
    CustomLog /var/log/apache2/access.log combined
</VirtualHost>

a2enmod rewrite
systemctl restart apache2.service

<?php
phpinfo();

; you may choose higher values for max_execution_time and memory_limit
max_execution_time = 600
memory_limit = 512M

error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT ; PHP 5.4.0 and higher
display_errors = Off

; or any higher values for post_max_size and upload_max_filesize
post_max_size = 256M
upload_max_filesize = 256M

; choose a non-zero value for session.gc_probability, otherwise old session data will not be deleted
session.gc_probability = 1
session.gc_divisor = 100
session.gc_maxlifetime = 14400
session.hash_function = 0
session.cookie_httponly = On
session.save_handler = files
; If you installation is served via HTTPS also use:
session.cookie_secure = On

; for chat server
allow_url_fopen = 1

; How many GET/POST/COOKIE input variables may be accepted
max_input_vars = 10000

systemctl restart apache2.service

apt install mariadb-server

systemctl restart mariadb.service

mysql -e "CREATE DATABASE ilias CHARACTER SET utf8 COLLATE utf8_general_ci;"
mysql -e "CREATE USER 'ilias'@'localhost' IDENTIFIED BY '<db-password>';"
mysql -e "GRANT LOCK TABLES on *.* TO 'ilias'@'localhost';"
mysql -e "GRANT ALL PRIVILEGES ON ilias.* TO 'ilias'@'localhost';"
mysql -e "FLUSH PRIVILEGES;"

cd /var/www/ilias/
sudo -uwww-data git clone https://github.com/ILIAS-eLearning/ILIAS.git . --single-branch -b release_10

sudo -uwww-data npm clean-install --omit=dev --ignore-scripts
sudo -uwww-data composer install --no-dev

cp /var/www/ilias/components/ILIAS/setup_/minimal-config.json /var/www/config/ilias.json

{
        "common" : {
                "client_id" : "myilias"
        },
        "database" : {
                "user" : "ilias",
                "password": "<db-passowrd>>",
                "database": "ilias",
                "create_database": true
        },
        "filesystem" : {
                "data_dir" : "/var/www/files/ilias"
        },
        "logging" : {
                "enable" : true,
                "path_to_logfile" : "/var/www/logs/ilias.log",
                "errorlog_dir" : "/var/www/logs/"
        },
        "http" : {
                "path" : "http://www.example.com"
        },
        "systemfolder" : {
                "contact" : {
                        "firstname" : "Richard",
                        "lastname" : "Klees",
                        "email" : "richard.klees@concepts-and-training.de"
                }
        },
        "utilities" : {
            "path_to_convert" : "/usr/bin/convert"
        },
        "mediaobject" : {
        "path_to_ffmpeg" : "/usr/bin/ffmpeg"
    },
    "preview" : {
        "path_to_ghostscript" : "/usr/bin/gs"
    },
}

sudo -uwww-data php cli/setup.php install /var/www/config/ilias.json

php cli/setup.php migrate

apt-get install postfix

mysqldump --lock-tables=false -u<database user> -p <database name> > /path/to/your/backup/folder/ilias-backup.sql
# Prompt for password

mysql -u<database-user> -p <database-name> < /path/to/your/backup/folder/ilias-backup.sql
# Prompt for password

sudo -uwww-data git pull origin release_10
sudo -uwww-data npm clean-install --omit-dev --ignore-scripts
sudo -uwww-data composer install --no-dev

sudo -uwww-data git fetch origin release_10:release_10
sudo -uwww-data git checkout release_10

sudo -uwww-data mkdir -p public/Customizing/plugins
mv data public/
mv Customizing/global/plugins/Services/* public/Customizing/plugins/
mv Customizing/global/plugins/Modules/* public/Customizing/plugins/

sudo -uwww-data npm clean-install --omit-dev --ignore-scripts
sudo -uwww-data composer install --no-dev

php cli/setup.php update

php cli/setup.php migrate

php cli/setup.php achieve database.resetFailedSteps

php /var/www/ilias/cli/cron.php run-jobs <user> <client_id>

*/5 * * * * www-data /usr/bin/php /var/www/ilias/cli/cron.php run-jobs cron myilias > /dev/null 2>&1

SQLSTATE[42000]: Syntax error or access violation: 1055 Expression #1 of
SELECT list is not in GROUP BY clause and contains nonaggregated column
'yourdbname.tblname.foobar' which is not functionally dependent on
columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by

[mysqld]
sql_mode=IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION

mysql -i -BN -e 'SELECT @@sql_mode' | grep -E 'ONLY_FULL_GROUP_BY|STRICT_TRANS_TABLES|STRICT_ALL_TABLES'

Package	Version	Reference System
Distribution	current version of Debian GNU Linux, Ubuntu or RHEL	Ubuntu 22.04 LTS
Database	MySQL >8.0.21 or MariaDB 10.5 - 10.11	MariaDB 10.6.18
PHP	8.2, 8.3	8.3
Webserver	nginx: 1.12.x – 1.18.x, Apache: ≥ 2.4.x	Apache 2.4.52
JDK	Open JDK Runtime 11, 17 or 21 LTS	OpenJDK 17
Node.js	20 (LTS), 21, 22 (LTS), 23 Recommended: 22	16.20
Ghostscript	10.x	9.55
Imagemagick	6.9.x	6.9.11
MathJax	MathJax 3, MathJax 2 with safe mode	2.7.9
Browser	a contemporary browser supporting ES6, CSS3 and HTML 5

ILIAS Version	PHP Version
10.x	8.2.x, 8.3.x
9.x	8.1.x, 8.2.x
8.x	7.4.x, 8.0.x
7.x	7.3.x, 7.4.x
6.x	7.2.x, 7.3.x, 7.4.x

ILIAS Version	MySQL Version	MariaDB Version
10.0 - 10.x	8.0.x	10.4, 10.5, 10.6
9.0 - 9.x	8.0.x	10.3, 10.4, 10.5, 10.6
8.0 - 8.x	5.7.x, 8.0.x	10.2, 10.3, 10.4
7.0 - 7.x	5.7.x, 8.0.x	10.1, 10.2, 10.3
6.0 - 6.x	5.6.x, 5.7.x, 8.0.x	10.0, 10.1, 10.2, 10.3

Installation and Maintenance

Functions

Installation ILIAS 10

ILIAS Installation

Table of Contents

System Requirements

Hardware

Supported Software Setup and Reference System

Installation on Ubuntu 24.04

Install Dependencies

Webserver Installation/Configuration

Database Installation/Configuration

Get the Code and Install ILIAS

Install ILIAS

Install Further Components

Install Plugins and Styles

Backup ILIAS

Upgrading ILIAS

Minor Upgrade

Major Upgrade

Update the Database

Information on Updates

Connect and Contribute

Appendix

Upgrading Dependencies

Configure Cron Jobs

Configure WebDAV

Hardening and Security Guidance

MySQL Strict Mode (5.7+)