Skip to main content
Version: ⭐ 24.10

Configuring your Centreon to send emails

For your Centreon to be able to send notification emails, you need to configure a local SMTP server.

This page gives you an example of a possible configuration. Refer to the official Postfix documentation for more information.

On some distributions, Postfix may already be installed.

Notification commands are executed by the poller that monitors the resource, so you need to configure the mail relay on all pollers.

We recommend that you use a dedicated email account to send notifications.

Step 1: Configuring Postfix​

  1. In your server's terminal, enter the following command:
dnf install postfix mailx cyrus-sasl-plain

  1. Restart Postfix:

    systemctl restart postfix

  2. Configure Postfix to run at startup:

    systemctl enable postfix

  3. Edit the following file:

    vi /etc/postfix/main.cf

  4. Add the following information:

myhostname = hostname
relayhost = [smtp.isp.com]:port
smtp_use_tls = yes
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_tls_CAfile = /etc/ssl/certs/ca-bundle.crt
smtp_sasl_security_options = noanonymous
smtp_sasl_tls_security_options = noanonymous
  • myhostname is the hostname of the Centreon server.
  • relayhost is the email server for the account that will send notifications.

In the following example, Centreon will use a Gmail account to send notifications:

myhostname = centreon-central
relayhost = [smtp.gmail.com]:587
smtp_use_tls = yes
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_tls_CAfile = /etc/ssl/certs/ca-bundle.crt
smtp_sasl_security_options = noanonymous
smtp_sasl_tls_security_options = noanonymous

  1. Restart Postfix:

    systemctl restart postfix

Step 2: Configuring the credentials of the account that will send emails​

  1. Create a /etc/postfix/sasl_passwd file:

    touch /etc/postfix/sasl_passwd

  2. Add the following line (replace username:password with the credentials of the account that will send the notification emails):

    [smtp.isp.com]:port username:password

    Example:

    [smtp.gmail.com]:587 username@gmail.com:XXXXXXXX

  3. Save the file.

  4. In the terminal, enter the following command:

    postmap /etc/postfix/sasl_passwd

  5. For security reasons, change the permissions on the file:

    chown root:postfix /etc/postfix/sasl_passwd*
    chmod 640 /etc/postfix/sasl_passwd*

  6. Reload Postfix so that changes are taken into account:

    systemctl reload postfix

Testing and troubleshooting email configuration​

  • To send a test email, enter the following command:

    echo "Test" | mail -s "Test" user@isp.com

    Replace user@isp.com with a real email address. The recipient should receive the test email.

  • If the user has not received the message, check the following log file (if it exists):

tail -f /var/log/maillog

  • To check that your Postfix service is running, enter:

    systemctl status postfix

    The results should look like this:

    image

Gmail configuration​

To use postfix with Gmail, you need to use an app password.