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'