Skip to main content
Version: 20.10

Using packages

Centreon provides RPM packages for its products through the Centreon Open Sources 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.

After installing your server, consider updating your operating system via the command:

dnf update

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

Pre-installation steps​

Disable SELinux​

SELinux should be disabled. To do this, you have to edit the file /etc/selinux/config and replace enforcing by disabled, or by running 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 firewall​

Add firewall rules or disable the firewall by running the following commands:

systemctl stop firewalld
systemctl disable firewalld

You can find instructions here to configure 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

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


This section describes how to install a Centreon Central server.

It's possible to 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

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

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.

Use the correct <PASSWORD> for user 'centreon'.

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

DROP USER 'centreon'@'<IP>';

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

Optionnaly, 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.


Set the PHP time zone​

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

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

Change Europe/Paris to your time zone. You can find the supported list of time zone here.

After saving the file, please do not forget to 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.

Web installation​

Before starting the web installation process, start the Apache server with the following command:

systemctl start httpd

Conclude installation by performing web installation steps.