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.


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:


    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:
  2. The SMTP server requires authentication and uses non-standard port 11019:
  3. Example for a Gmail account: the SMTP server requires authentication and TLS is enabled:[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:[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.