config mail System Administrator Jahia 7.3 Jahia 8 Legacy

Configuration Mail Server in Jahia

Question

How to configure mail server in Jahia administration URL field?

Answer

From https://jira.jahia.org/browse/JKB-20

How can I configure a mail server in Jahia 6.5/6.6 and Jahia 7.x?

The e-mail server configuration is available in the {code}Jahia Administration --> Server Settings --> E-mail settings{code}

Description of input fields

  1. Mail server: field contains the SMTP hostname, optionally with advanced options.
    Jahia uses now Apache Camel framework for messaging and the format of the mail endpoint should conform to the one, required by Camel Mail Component (http://camel.apache.org/mail.html ), i.e.:
    All parts except host are optional. See use cases below.
    [smtp|smtps]://[username@]host[:port][?options]
  2. Mail administrator: field contains a single e-mail address or multiple addresses, separated by a comma, of users, who will receive system-level notifications (e.g. about errors, if this option is enabled)
  3. Mail from: the default sender e-mail address for an e-mail message

Use cases

Here are several use cases for "Mail server" field values:

  1. SMTP server does not require authentication and uses standard port 25:
    smtp.acme.com
  2. SMTP server requires authentication and uses non-standard port 11019:
    smtp.acme.com:11019?username=myuser&password=secretpassword
  3. GMail example: SMTP server requires authentication and SSL enabled (or TLS):
    smtps://smtp.gmail.com?username=acme@gmail.com&password=mypassword
    or
    smtp.gmail.com:587?username=acme@gmail.com&password=mypassword&mail.smtp.starttls.enable=true
    Warning: due to improved security measures at Google, you will either have to enable less secure app access ([https://www.google.com/settings/security/lesssecureapps]) on the account if you are not using 2-step verification.
    If you are using 2-step verification you will need to set up an app-specific password here : [https://security.google.com/settings/security/apppasswords]
  4. Enabling mail server debugging option to see the details of e-mail server communication:
    smtp.acme.com?mail.debug=true