SMTP Configuration

The server sends email to known users for functionalities such as password reset, user invitations or device enrollments and to administrators to warn about certificate expiries, for example. The SMTP connectivity endpoint and credentials are configured in the application.yml:

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

The settings shown above are the defaults when unconfigured. SMTP connectivity is tested as part of the server health checks displayed in the system portal.

Amazon Simple Email Service (SES) SMTP

The recommended settings for connecting to Amazon SES are as follows:

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

Notice the SMTP username and password parameters are an AWS access key and secret key of an IAM user having AmazonSesSendingAccess permissions granting ses:SendRawEmail rights. Please make sure to state the correct region as part of host. These settings can be looked up in SMTP Settings page of SES service in AWS console.

Microsoft Office365 SMTP

The recommended settings for sending Mail through Office365 are as follows:

Under Settings - Organisation, the "E-Mail from" field must contain the same email address used in the application.yml "username" field. You must also verify that SMTP AUTH is enabled for the mailbox being used.

relution:
  mail:
    username: 'email@somehwere,de'
    password: 'xxx'
    host: smtp.office365.com
    port: 587
  smtp:
    ehlo: false
spring:
    mail:
      properties:
        mail:
          smtp:
            auth: true
            starttls.enable: true