Skip to main content
Version: 21.04

Using packages

Centreon provides RPM packages for its products through the Centreon Open Source version available free of charge in our repository.

These packages have been successfully tested in CentOS 7 and 8 environments.

Due to Red Hat's stance on CentOS 8, we suggest not to use said version for your production environment. Nevertheless, these packages for CentOS 8 are compatible with RHEL 8 and Oracle Linux 8 versions.

You must run the installation procedure as a privileged user.


After installing your server, update your operating system using the following command:

dnf update

Accept all GPG keys and reboot your server if a kernel update is proposed.

Step 1: Pre-installation​

Disable SELinux​

During installation, SELinux should be disabled. To do this, edit the file /etc/selinux/config and replace enforcing by disabled. You can also run the following command:

sed -i s/^SELINUX=.*$/SELINUX=disabled/ /etc/selinux/config

Reboot your operating system to apply the change.


After system startup, perform a quick check of the SELinux status:


You should have this result:


Configure or disable the firewall​

If your firewall is active, add firewall rules. You can also disable the firewall during installation by running the following commands:

systemctl stop firewalld
systemctl disable firewalld

Install the repositories​

Redhat CodeReady Builder repository​

To install Centreon you will need to enable the official CodeReady Builder repository supported by Redhat.

Enable the CodeReady Builder repository using these commands:

dnf -y install dnf-plugins-core
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms

Enable PHP 7.3 using the following command:

dnf module enable php:7.3 -y

Check that PHP 7.3 is activated:

dnf module list php

You should have this result:

Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
Name Stream Profiles Summary
php 7.2 [d] common [d], devel, minimal PHP scripting language
php 7.3 [e] common [d], devel, minimal PHP scripting language
php 7.4 common [d], devel, minimal PHP scripting language

Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled

Centreon repository​

To install Centreon software from the repository, you should first install the centreon-release package, which will provide the repository file.

Install the Centreon repository using this command:

dnf install -y

Step 2: Installation​

This section describes how to install a Centreon central server.

You can install this server with a local database on the server, or a remote database on a dedicated server.

With a local database​

dnf install -y centreon centreon-database
systemctl daemon-reload
systemctl restart mariadb

You can now move to Step 3.

With a remote database​

If installing database on a dedicated server, this server should also have the prerequired repositories.

Run the following command on the Central server:

dnf install -y centreon-base-config-centreon-engine centreon-widget\*

Then run the following commands on the dedicated server:

dnf install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb

Secure your MariaDB installation by executing the following command:


It is mandatory to set a password for the root user of the database.

Then create a distant user with root privileges needed for Centreon installation:


Replace <IP> with the Centreon Central IP address that will connect to the database server.

Replace <USER> and <PASSWORD> by user's credentials.

Once the installation is complete you can delete this user using:


The package centreon-database installs an optimized MariaDB configuration to be used with Centreon.

If this package is not installed, system limitation LimitNOFILE should be at least set to 32000 using a dedicated configuration file, example:

$ cat /etc/systemd/system/mariadb.service.d/centreon.conf

Same for the MariaDB open_files_limit directive, example:

$ cat /etc/my.cnf.d/centreon.cnf

In addition to the directives above, it's strongly recommended to tune the database configuration with the following parameters:

key_buffer_size = 256M
sort_buffer_size = 32M
join_buffer_size = 4M
thread_cache_size = 64
read_buffer_size = 512K
read_rnd_buffer_size = 256K
max_allowed_packet = 128M

Optionally, tune the memory and buffer utilization of the InnoDB engine powered tables. The example below applies to a database server with 8Gb RAM


Remember to restart MariaDB after a change to configuration.

Step 3: Configuration​

Server name​

If you want, you can change the server's hostname using the following command:

hostnamectl set-hostname new-server-name

Replace new-server-name by the name you want. Example:

hostnamectl set-hostname central

Set the PHP time zone​

You are required to set the PHP time zone. Run the following command as root:

echo "date.timezone = Europe/Paris" >> /etc/php.d/50-centreon.ini

Replace Europe/Paris by your time zone. You can find the list of supported time zones here.

After saving the file, restart the PHP-FPM service:

systemctl restart php-fpm

Services startup during system bootup​

To make services start automatically during system bootup, run these commands on the central server:

systemctl enable php-fpm httpd mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd

If the database is on a dedicated server, remember to enable mariadb service on it.

Secure the database​

Since MariaDB 10.5, it is mandatory to secure the database's root access before installing Centreon. Run the following command:

  • Answer yes to all questions except "Disallow root login remotely?".
  • It is mandatory to set a password for the root user of the database. You will need this password during the web installation.

For more information, please see the official MariaDB documentation.

Step 4: Web installation​

  1. Start the Apache server with the following command:
systemctl start httpd
  1. To complete the installation, follow the web installation steps procedure.