Mail Configuration

dotCMS expects there to be a global mail provider configured as mail/MailSession. You can configure this by setting environment variables.

Environment Variables Example#


You can use environment variables to configure SMTP service to be used by dotCMS when sending emails. Below are examples of how to use environment variables to configure SMTP:

SMTPS#

Configure dotCMS to use use SMTPS (note the relevant environmental variables have MAIL_SMTPS in them).

DOT_MAIL_TRANSPORT_PROTOCOL: smtps DOT_MAIL_SMTPS_HOST: email-smtp.us-east-1.amazonaws.com DOT_MAIL_SMTPS_USER: abc123 DOT_MAIL_SMTPS_PASSWORD: 123abc DOT_MAIL_SMTPS_AUTH: 'true' DOT_MAIL_SMTPS_PORT: '465'

SMTP+TLS#

Configure dotCMS to use SMTP + starttls:

DOT_MAIL_TRANSPORT_PROTOCOL: smtp DOT_MAIL_SMTP_HOST: email-smtp.us-east-1.amazonaws.com DOT_MAIL_SMTP_USER: abc123 DOT_MAIL_SMTP_PASSWORD: 123abc DOT_MAIL_SMTP_AUTH: 'true' DOT_MAIL_SMTP_PORT: '587' DOT_MAIL_SMTP_STARTTLS_ENABLE: 'true'

SMTP Servers With Untrusted SSL Certificates#

To connect to SMTP servers with untrusted SSL certificates, use either:

DOT_MAIL_SMTP_SSL_TRUST: 'smtp.example.com'

or

DOT_MAIL_SMTPS_SSL_TRUST: 'smtp.example.com'