How to install Moodle on CentOS 7

How to Install Moodle on CentOS 7

Moodle is a popular open-source learning management system (LMS) written in PHP. It was built to help educators easily create quality online courses. In this article, we will show you how to install Moodle on a CentOS 7.

Moodle Requirements

In order to run Moodle on your CentOS 7 server, you need the following requirements pre-installed:

  • Web Server: Apache >= 2.0 compiled with mod_rewrite module, or Nginx
  • PHP >= PHP 7.0 or above is recommended, with the following PHP extensions enabled: intl, Zip, XMLRPC, Soap and opcache
  • MySQL 5.5.31 or later, MariaDB 5.5.31 or later or PostgreSQL 9.3 or later installed on your CentOS virtual server
  • CentOS 7 VPS with root access enabled.

1. Login via SSH

Log in to your CentOS 7 VPS via ssh as user root

ssh roo@IP_Address -p Port_number

2. Update all packages

Once you are logged in to the server run the following command to make sure that all installed packages are up to date

yum clean all
yum update

3. Install LAMP stack

As mention in the requirements section of the tutorial, a LAMP stack (Apache, MySQL/MariaDB, and PHP) is required to run Moodle on the server. We will start with installing Apache web server

yum -y install httpd

Start the Apache web server and enable it to start upon server boot

systemctl enable httpd

PHP version 7.1 is not available in the default CentOS 7 repositories so we will use the Remi repository.

To install and enable both EPEL and Remi repositories run the following commands:

yum install epel-release
rpm -Uhv
yum-config-manager --enable remi-php71

Install PHP 7.1 and all necessary PHP modules using the following command:

yum install php php-common php-intl php-zip php-soap php-xmlrpc php-opcache php-mbstring php-gd php-curl php-mysql php-xml

During the installation, the yum package manager will prompt you to install the Remi GPG Signing key. Accept the key by typing ‘y’ and the package manager will install all necessary PHP extensions.

In order to complete the LAMP installation, install the MariaDB database server using the following command:

yum -y install mariadb mariadb-server

Start the MariaDB service and set it to start on reboot

systemctl start mariadb
systemctl enable mariadb

Run the ‘mysql_secure_installation’ post-installation script provided by MariaDB to strengthen the security of the database server and set a root password. You can use the following options:

Set root password? [Y/n] Y
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

4. Install Moodle on CentOS 7

Moodle is not available in the official CentOS 7 repositories, so we will have to download the latest stable version from the official website page at and extract the Moodle archive to a directory on the server by executing the following commands:

cd /opt
wget -O moodle-latest.tgz
tar -xvzf moodle-latest.tgz
mv /opt/moodle/ /var/www/html/moodle/

This will create a new directory named ‘moodle’ containing the necessary files and directories.
Change the ownership of the /var/www/html/ directory:

chown -R apache:apache /var/www/html/

5. Configure Apache to serve Moodle

Create a new Apache configuration file and add the following contents below to the /etc/httpd/conf.d/moodle.conf file using vi or your favorite text editor:

# vi /etc/httpd/conf.d/moodle.conf

Add the following lines:

<VirtualHost *:80>
DocumentRoot /var/www/html/moodle

Alias /moodle “/var/www/html/moodle/”
<Directory /var/www/html/moodle/>
Options +FollowSymlinks
AllowOverride All


ErrorLog /var/log/httpd/moodle-error_log
CustomLog /var/log/httpd/moodle-access_log common

Save the changes and restart the Apache web server for the changes to take effect:

systemctl restart httpd

6. Create a MariaDB database for Moodle

Log into MariaDB with the root account:

# mysql -u root -p

Now we will create a MariaDB database for Moodle using the following query:

mysql> CREATE DATABASE moodledb;

Add a separate user for Moodle that will interact with the database:

mysql> GRANT ALL PRIVILEGES ON moodledb.* to 'moodle'@'localhost' IDENTIFIED BY '5tr0ng_Pa55w0rd';

Execute the following command to apply the privileges we set:


Now we can exit the MariaDB session:

Need a fast and easy fix?
✔ Unlimited Managed Support
✔ Supports Your Software
✔ 2 CPU Cores
✔ 2 GB RAM
✔ 50 GB PCIe4 NVMe Disk
✔ 1854 GeekBench Score
✔ Unmetered Data Transfer

Now just $43 .99

mysql> quit

Edit the MariaDB configuration file (/etc/my.cnf.d/server.cnf) and add the following lines:

default-character-set = utf8mb4

innodb_file_format = Barracuda
innodb_file_per_table = 1
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

default-character-set = utf8mb4

Restart MariaDB service for the changes to take effect

service mariadb restart

You can now open a web browser and access the Moodle application at

From here you can finish the setup by following the steps below:

  • Choose a language for the Moodle installation.
  • Confirm the website address, Moodle directory, and data directory.
  • Choose a database driver (improved MySQL or MariaDB).
  • Enter the database settings: localhost or as database host, then enter a database name, username, password, database port (3306), and once you have filled in the form, click Next.
  • Edit the /var/www/html/moodle/config.php configuration file and replace ‘mysqli’ with ‘mariadb’.
  • Moodle will check to make sure that your server meets the Moodle requirements. If everything is OK, click Next.
  • Enter a username, password and email address for the administrator user account.
  • Complete registration with

Install Moodle on CentOS 7

That’s it, now you should have successfully installed Moodle on your CentOS 7 server.

Installing Moodle on CentOS 7Of course, you don’t have to install and configure Moodle on CentOS 7, if you use one of our Managed Moodle Hosting solutions, in which case you can simply ask our expert Linux admins to install and configure Moodle on CentOS for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post on how to install and configure Moodle on a CentOS VPS, please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

Leave a Comment