Skip to main content
Version: 21.04

Using Centreon ISO

Installing a Remote Server is similar to installing a Centreon Central Server.

If you want to install Centreon on CentOS / Oracle Linux / RHEL distribution in version 8, you must use RPM packages


Download the ISO from Centreon's download site.

Step 1: Startup the server

To install Centreon, start up your server from the Centreon ISO image in version el7. Start up with Install CentOS 7:


Step 2: Choose a language

Choose the language for the installation process and click on Continue:


Step 3: Select the component

Click on the Installation Type menu:


You have different options to choose from:


  • Central with database: Install Centreon (web interface and database), monitoring engine and Broker.
  • Central without database: Install Centreon (web interface only), monitoring engine and Broker.
  • Poller: Install poller (monitoring engine and Broker only).
  • Database: Install database server (if you have already installed a Central server without a database option).

After selecting your installation type, click Done.

Step 4: System configuration

Configure disk Partitioning

Click on the Installation Destination menu:


Select the hard disk drive and the I will configure partitioning option. Then click on Done:


Using the + button, create your own partitioning file system following the instructions in prerequisites chapter. Then click on Done:


It is recommended to use LVM as the default partitioning scheme.

A confirmation window appears. Click on Accept Changes to validate the partitioning:


Configure the timezone

Click on the Date & Time menu:


Select the time zone and then click the gear button to configure the NTP server:


Type in the name of the NTP server you wish to use and click the plus button. Or, select one from the list of predefined NTP servers then click OK and then Done:


It is okay that you can't enable the “network time” option in this screen. It will become enabled automatically when you configure the network and hostname.

Configure the network

Click on the Network & Hostname menu:


Enable all network interfaces by clicking the button in the top right from off to on. Then click on Done:


Begin the installation

Once configuration is complete, click on Begin Installation:


Click on Root Password:


Define and confirm the root user password. Click on Done:


Wait for the installation process to finish. You can also use this time to add additional users to the system if you desire.


When the installation is complete, click on Reboot:


Server name

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

hostnamectl set-hostname new-server-name

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

hostnamectl set-hostname remote1

Update the system

Connect to your server using a terminal, and execute the command:

yum update

Accept all GPG keys if you are prompted

Then restart your server with the following command:


Services startup during system bootup

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

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

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.

Web installation

Conclude installation by performing web installation steps.

During web installation, it is not necessary to install Autodiscovery module.

In the step Initialization of the monitoring, only the actions from 6 to 8 must be done.

Register the server

To transform the server into a Remote Server and register it to the Centreon Central server, execute the following command:

/usr/share/centreon/bin/ -u <API_ACCOUNT> \
-t remote -h <IP_TARGET_NODE> -n <POLLER_NAME>


/usr/share/centreon/bin/ -u admin -t remote -h -n remote-1

Replace <IP_TARGET_NODE> by the IP of the Centreon server seen by the Remote Server.

The <API_ACCOUNT> must have access to configuration API. You can use default admin account.

If you need to change the HTTP method or the port, you can use the following format for the -h option: HTTPS://<IP_TARGET_NODE>:PORT

Then follow instructions by

  1. Entering your password: please enter your password:
  2. Select the IP address if multiple network interfaces exist:

    Which IP do you want to use as CURRENT NODE IP ?
  3. Then validate the information:

    Summary of the informations that will be send:

    Api Connection:
    username: admin
    password: ******
    target server:

    Pending Registration Server:
    name: remote-1
    type: remote

    Do you want to register this server with those informations ? (y/n)y
  4. Add additional information to enable future communication between your Remote Server and its Central, fill in the required information to convert your platform into a Remote server:

    <CURRENT_NODE_ADDRESS> : Please enter your username:
    <CURRENT_NODE_ADDRESS> : Please enter your password:

    <CURRENT_NODE_ADDRESS> : Protocol [http]:
    <CURRENT_NODE_ADDRESS> : Port [80]:
    <CURRENT_NODE_ADDRESS> : centreon root folder [centreon]:
  5. If you use a proxy, please define credentials:

    Are you using a proxy ? (y/n)
    enter your proxy Host:
    enter your proxy Port [3128]:
    Are you using a username/password ? (y/n)
    enter your username:
    enter your password:

You will receive the validation of the Centreon central server:

2020-10-16T17:19:37+02:00 [INFO]: The CURRENT NODE 'remote: 'remote-1@' has been converted and registered successfully.

Main errors messages

2020-10-20T10:23:15+02:00 [ERROR]: Invalid credentials

Your credentials are incorrect for the <API_ACCOUNT>.

2020-10-20T10:24:59+02:00 [ERROR]: Access Denied.

The <API_ACCOUNT> doesn't have access to configuration API.

Failed connect to; Connection refused

Unable to access to the API. Please check <IP_TARGET_NODE>, scheme and port.

2020-10-20T10:39:30+02:00 [ERROR]: Can’t connect to the API using:

The access url is not complete or is invalid. Use the --root option to define the API URL Path. For example: --root monitoring.

2020-10-20T10:42:23+02:00 [ERROR]: No route found for “POST /centreon/api/latest/platform/topology”

Your Centreon target version is invalid. It should be greater or equal to 21.04.

Extend local DBMS rights

Finally, add rights to centreon database user to use LOAD DATA INFILE command:

GRANT FILE on *.* to 'centreon'@'localhost';

Add the Remote Server to configuration

Go to the Add a Remote Server to configuration.

Secure your platform

Don't forget to secure your Centreon platform following our recommendations