Skip to main content
Version: 21.10

Using Centreon ISO

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 a Centreon Poller, 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).

Select Poller and 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 poller1

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:


After the machine has been rebooted, enable the services to allow centengine to be running on startup.

systemctl enable centreon centengine centreontrapd snmptrapd

Passive monitoring services can be started:

systemctl start centreontrapd snmptrapd

Restart Centreon Engine:

systemctl restart centengine

Register the server

To turn the server into a poller and to register it to the Central server or to a Remote server, execute the following command on the future poller:

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


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

Replace <IP_TARGET_NODE> by the IP of the central server or remote server that you want to link the poller to (IP as seen by the poller)

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 adress 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: poller-1
    type: poller

    Do you want to register this server with those informations ? (y/n)y

You will receive the validation of the Centreon central or the Remote Server server:

2020-10-16T17:19:37+02:00 [INFO]: The CURRENT NODE 'poller': 'poller-1@' linked to TARGET NODE: '' has been added

Main error 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 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.10.

Add the Poller to configuration

Go to the Add a Poller to configuration.

Secure your platform

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