Configuring mail server settings

  Written by The Jahia Team
   Estimated reading time:

In the Mail server settings page, you can edit the settings for the mail server used to send e-mail notifications. These parameters should have been entered previously when installing the Jahia server.

admin-server-mail-server.png

To configure your mail server correctly, start by entering your SMTP server address. Then you can enter the system administrator’s e-mail address. They will receive e-mail notifications if system errors occur. You can also define the e-mail address from which the automatic system-level notifications will originate. Of course, this e-mail address must be recognized and accepted by the SMTP server.

Here is additional information about these settings in Administration>Server>Configuration>Mail server settings:

  • Mail server: this field contains the e-mail server’s SMTP address. It may contain some advanced properties like:

    The value in this field should be formatted as follows:

    <username>:<password>@<smtp-host>:<smtp-port>[Parameter1=Value1,Parameter2=Value2,...]

    All arguments are optional, except <smtp-host>. Should you need more details, you will find examples of use further down.

    • port number: if not using the standard SMTP port (25)
    • username and password: if the SMTP server requires authentication
    • additional properties: in order to enable TLS, for instance.
  • The Mail administrator field contains one or more e-mail addresses separated by commas. Each of these users will receive system-level notifications (if enabled).
  • The Mail from field will be used as the sender address for the e-mail notifications.
  • Disable workflow task notifications prevent workflows from sending emails.

In order to illustrate various possible configurations, here are a few examples of use:

  1. The SMTP server does not require authentication and uses standard port 25:
    smtp.acme.com
  2. The SMTP server requires authentication and uses non-standard port 11019:
    username:secret-password@smtp.acme.com:11019
  3. Example for a Gmail account: the SMTP server requires authentication and TLS is enabled:
    acme@gmail.com: secret-password@smtp.gmail.com:587[mail.smtp.starttls.enable=true]
  4. If necessary, this enables advanced e-mail debugging options in order to see the details of communication with the SMTP server:
    smtp.acme.com:25[mail.debug=true]

Finally, the event notification level option is only used to send notification e-mails about system errors. Only system administrators of the platform are affected by this option (see further up for the list of recipients).

On the other hand, the e-mail server configuration affects all e-mail notifications in Jahia (including workflow notifications for instance) and not only system-level notifications.