Mail dispatch

Introduction #

Starting with Relution Server version 5.22, the SMTP server connection can be configured via web interface. This connection is necessary if Relution is to actively send emails. These can be, for example, emails for a password reset, registration or notification. The connection of an SMTP server is optional. Until version 5.21, the connection to the SMTP server had to be configured on the server via the application.yml.

Configuration #

As a system administrator, the category Email Configuration is available in the Global organization in Settings. The configuration of the SMTP server includes the typical parameters:

• Host
• Port
• User name
• Password

These SMTP configurations can also be made:

• StartTLS
• SSL
• EHLO
• Sender email

The configuration can be tested directly in the mask using the corresponding button.

application.yml #

relution:
  mail:
    username:
    password:
    host: localhost
    port: 25
  smtp:
    ttls: false
    ssl: false
    ehlo: true

The settings shown above are the default values if they are not configured. SMTP connectivity is tested as part of the server health check, which are displayed in the System Portal.

Amazon Simple Email Service (SES) SMTP #

The recommended settings for connecting to Amazon SES looks like:

relution:
  mail:
    username: ABCDEFGHIJKLMNOPQ123
    password: "abcdefghijklmnopqrstuvwxyz/BASE64+1234567890"
    host: email-smtp.eu-central-1.amazonaws.com
    port: 587
  smtp:
    ttls: true
    ssl: true
    ehlo: true

Note that the SMTP parameters username and password are an AWS access key and a secret key of an IAM user with AmazonSesSendingAccess permissions, which must be ses:SendRawEmail permissions. Please make sure that you have specified the correct region as part of host. These settings can be found on the SMTP Settings page of the SES service in the AWS console.

Microsoft Office365 SMTP #

The recommended settings to be able to send mail via Office 365 are these:

Under Settings - Notifications - E-Mail and SMS, in the field E-Mail from should contain the same email address as in the application.yml in the field username. You must make sure that SMTP AUTH is enabled for the corresponding account.

relution:
  mail:
    username: "email@somehwere.com"
    password: "xxx"
    host: smtp.office365.com
    port: 587
  smtp:
    ttls: true
    ssl: false
    ehlo: true