Operating System CentOS

How to Install Chamilo LMS 3.0 on Ubuntu 26.04

Install the Chamilo 3.0 learning management system on Ubuntu 26.04 LTS with Apache, PHP 8.5 and MariaDB, following the project's own procedure.

Chamilo is a GPLv3 learning management system for courses, quizzes, learning paths and reporting. This guide installs the current major version, Chamilo 3.0, with Apache, PHP and MariaDB on Ubuntu 26.04 LTS, and notes where Ubuntu 24.04 LTS differs. Ubuntu is used because it is the platform Chamilo's own installation instructions are written for (24.04 LTS or later). Chamilo 1.11.8 and CentOS 7 are both out of date: CentOS 7 reached end of life in June 2024, and Chamilo 3.0 requires PHP 8.3 or newer, which that system never shipped.

Requirements

  • A server with Ubuntu 26.04 LTS, at least 2 vCPUs, 4 GB of RAM and 4 GB of free disk space (the project's stated minimum).
  • A user with sudo rights.
  • A domain or subdomain of its own, for example chamilo.example.com, pointing to the server. Chamilo must not be installed in a subfolder of a site that hosts another application.
  • PHP 8.3, 8.4 or 8.5 and MariaDB 10 or newer (MySQL 5.7 or newer also works). Ubuntu 26.04 provides PHP 8.5; Ubuntu 24.04 provides PHP 8.3. Both are supported, and the package names below are the same on both releases.

Step 1: Install Apache, PHP and MariaDB

sudo apt update && sudo apt -y upgrade
sudo apt install -y apache2 libapache2-mod-php mariadb-client mariadb-server php-{apcu,bcmath,cli,curl,dev,gd,intl,ldap,mbstring,mysql,redis,soap,xml,zip} unzip curl

This is the package list from the Chamilo README. The LDAP extension is only used if you connect Chamilo to a directory service, but it does no harm when unused.

Step 2: Create the database user

Create a MariaDB account for Chamilo and give it rights on the database the installer will create. Replace the password with your own:

sudo mysql -e "CREATE USER chamilo@localhost IDENTIFIED BY 'replace-with-a-strong-password';"
sudo mysql -e "GRANT ALL PRIVILEGES ON chamilo.* TO chamilo@localhost;"

Step 3: Download Chamilo

Release 3.0.2 (3 November 2026) is published as a zip archive whose files are not wrapped in a top-level folder, so create the target directory first and unpack inside it:

sudo mkdir /var/www/chamilo
cd /var/www/chamilo
sudo wget https://github.com/chamilo/chamilo-lms/releases/download/v3.0.2/chamilo-3.0.2.zip
sudo unzip -q chamilo-3.0.2.zip
sudo rm chamilo-3.0.2.zip

Check the project's releases page on GitHub for a newer 3.0.x version before you download, and adjust the file name accordingly. Use the packaged release, not the "Source code" archives: those lack the built front-end and dependencies.

Step 4: Configure Apache

Chamilo ships a virtual host template. Copy it, replace the placeholder domain and enable the site along with the modules it needs:

sudo cp public/main/install/apache.dist.conf /etc/apache2/sites-available/chamilo.example.com.conf
sudo sed -i 's/my\.chamilo\.net/chamilo.example.com/' /etc/apache2/sites-available/chamilo.example.com.conf
sudo a2ensite chamilo.example.com
sudo a2enmod rewrite ssl headers expires

The template sets the document root to /var/www/chamilo/public/, allows .htaccess overrides and raises the PHP memory and upload limits to 256M for this site. Edit those values in the file if you need larger uploads.

Step 5: Set permissions for the installer

The web installer writes the .env file and needs write access to config/ and var/:

cd /var/www/chamilo
sudo touch .env
sudo chown -R www-data: .env config/ var/
sudo systemctl restart apache2

If UFW is enabled, allow web traffic:

sudo ufw allow "Apache Full"

Step 6: Run the web installer

Open http://chamilo.example.com in a browser. You are redirected to main/install/index.php. Follow the wizard: choose the language, review the requirements check, then enter the database details from step 2 (user chamilo, your password, database name chamilo, default host and port) and create the administrator account.

When the wizard has finished, take write access to the configuration away from the web server again:

cd /var/www/chamilo
sudo chown -R root: .env config/

Leave var/ owned by www-data; Chamilo keeps its cache, logs and uploaded files there.

Step 7: Enable HTTPS

An LMS handles logins and personal data, so do not run it over plain HTTP. With the DNS record in place, Certbot can obtain a Let's Encrypt certificate and adjust the virtual host for you:

sudo apt install -y certbot python3-certbot-apache
sudo certbot --apache -d chamilo.example.com

Afterwards log in at https://chamilo.example.com and check that the platform URL in the administration settings uses https.

Configuration and maintenance

Most settings are changed in the administration pages. The database connection and other low-level settings are in /var/www/chamilo/.env. The Symfony configuration in config/packages/*.yaml is replaced by every update; if you need to change it, copy the file into config/packages/prod/ and edit the copy.

Back up the database and the installation directory regularly, and always before an update:

sudo mysqldump --single-transaction chamilo | gzip > ~/chamilo-$(date +%F).sql.gz
sudo tar czf ~/chamilo-files-$(date +%F).tar.gz -C /var/www chamilo

Chamilo publishes frequent security releases. Watch the releases page and follow the upgrade notes of each release.

If a page fails with an HTTP 500 error, read /var/log/apache2/error.log first. The 3.0 installer also explains what to do on servers where PCRE JIT is blocked; the shipped Apache template already sets pcre.jit to 0 for the site.

Frequently asked questions

Should I still install Chamilo 1.11?

Not for a new site. The 1.11.x and 2.0 branches still received security releases in November 2026 (1.11.42 and 2.0.4), which helps existing installations, but new features go into 3.0 and it is the version the project's installation instructions describe.

Can I run Chamilo 3.0 on AlmaLinux or Rocky Linux 9?

The stated requirements are a web server, PHP 8.3 to 8.5 and MariaDB or MySQL, so it is possible if you provide a matching PHP version, but the project only documents the Ubuntu procedure. The package names, the Apache layout and SELinux handling differ and are not covered by the upstream instructions.

Does the web server need write access to the whole directory?

No. Only var/ has to stay writable after installation. .env and config/ need write access during the installer and should be owned by root afterwards, as shown in step 6.

How many users can this server handle?

The project states that it has not published load tests for 3.0. Treat the 2 vCPU / 4 GB minimum as a starting point for a small school or team and monitor CPU, memory and database load as usage grows.

Share story:

Continue reading other guides on How VPS.