Using a virtual machine (VM)
On its download page, Centreon provides a ready-to-use virtual machine. This virtual machine is available in OVA format for VMware environments and for Oracle VirtualBox. It is based on the Linux CentOS 7 operating system and includes a Centreon installation that allows you to easily start your first monitoring.
The VM uses the Thin Provision option to save as much free space as possible on the disk (this is best practice).
The host machine must have the following characteristics:
- Processor: any recent Intel or AMD processor with at least 2 vCPUs.
- Memory: depending on your operating system, you will need at least 1 GB of RAM. To fully enjoy the Centreon experience, you need at least 2 GB of free memory.
- Hard Disk storage: The virtual machine requires at least 6.5 GB of free space on your hard disk. However, if you want keep using Centreon, it is recommended to have at least 10 GB as its size will grow over time.
Step 1: Downloading the virtual machine
Make sure your virtualization tool (VMWare or VirtualBox) is installed on your machine and up to date.
Go to the Centreon download page. In section 1, Appliances is already selected.
In section 2, select which version of Centreon you want to download.
In section 3, Download your image, click the Download button next to VMWare Virtual Machine (OVA). A new page opens.
If you want Centreon to contact you, fill in your details, then click Download.
Otherwise, click Direct download.
The file you have downloaded is an archive file: extract its contents to the folder you want.
Step 2 : Installing the virtual machine
- VMware environment
- Oracle VirtualBox
Import the centreon-central.ova file into VMWare. A terminal window opens: wait for the server to start. When it is ready, the terminal shows the following message:
According to how your network is set up, in the configuration of your virtual machine, add a network adapter and select the network through which the virtual machine can communicate with the resources it will supervise. Here is an example of configuration in VSphere 6:
Import the centreon-central.ova file into VirtualBox. The VM is added to your list of VMs in VirtualBox.
In the right-hand panel, click Settings. The Settings dialog box opens.
On the System tab, check the Hardware Clock in UTC Time box.
According to how your network is set up, add a network adapter and select the network through which the virtual machine can communicate with the resources it will supervise. For instance:
On the Network tab, select Enable Network Adapter.
In the Attached to list, select Bridged Adapter.
In the Name list, select the network card you want.
In the right-hand panel, click Start to start the VM. A terminal window opens: wait for the server to start. When it is ready, the terminal shows the following message:
Step 3 : Completing the configuration
Log in to the Centreon server using the following credentials: login:
To know your server's IP address, type
ip addr. (By default, the VM has a qwerty keyboard: if you have an azerty keyboard, enter
ip qddr.) The VM is configured to obtain an IP address from the DHCP server automatically.
Log in to the server from another machine, as user
root, using the terminal you want and the IP address you obtained at the previous step.
The first time you connect to the server, instructions are displayed to help you complete the configuration:
Change the following settings:
The timezone for the Centreon server. By default, it is set to UTC. This will set the time for the various Centreon logs.
Use the following command:
timedatectl set-timezone your_timezone
For example, to set the timezone to Europe/London, type:
timedatectl set-timezone Europe/London
You can get a list of all available timezones using this command:
The timezone for the php server. To avoid errors, this should be the same as the timezone of the server. By default, it is set to Europe/London.
Open the following file:
date.timezone, define the timezone you want.
Restart the php server:
systemctl restart php-fpm
The hostname of your server. The default name is
centreon-central. To change it, use the following command:
hostnamectl set-hostname your-hostname
For example, if you want your machine to be called
hostnamectl set-hostname supervision
Add a MariaDB table partition: this step is mandatory. Your Centreon server will not work if this isn't done.
Connect as user
su - centreon
Type the following command:
The partition is created:
Connect back as user
Restart the Centreon broker process so that changes are taken into account:
systemctl restart cbd centengine gorgoned
Your Centreon server is now ready to use.
Once those operations have been carried out, you can get rid of the message that describes them in the terminal. To do so, delete the following file:
To log in to the web interface, go to
http://FQDN/centreon. (For example, a valid URL would be
Log in using the following credentials: Login:
centreon. By default, your server has a predefined configuration to monitor the Centreon server itself.
According to your Centreon edition, you may have to add a license.
Update your Centreon platform.
Secure your Centreon platform. We recommend that you change the passwords for the root and admin accounts, and that you define a password for the MariaDB database.
You can now monitor your first host.
- To log in to the Centreon web interface, the default credentials are:
- The server administration account (using SSH) is:
- The root password of the DBMS is not initialized.
For security reasons, we highly recommend you change those passwords after you complete the installation.