Mail Configuration
- Thomas Körbler
Portrait relies on authentication based on email-addresses. Therefore, Portrait requires an SMTP connection to be able to send invites, verify-links and password-resets per E-Mail.
You can either use your internal SMTP server or a dedicated and paid service provider.
SMTP providers known to us:
Given your use-case and the amount of mails you send, some of the aforementioned services can be free of charge for you.
Since external SMTP providers are optimized for transactional mailing, the changes are more likely, that your email invites or password-resets are not considered as spam.
Microsoft does not recommend using your Office 365 tenant for sending mails via SMTP.
Settings
Name |
|
|---|---|
mail.host | Address of the SMTP Server. |
mail.port | Port. Usually |
mail.username | Name or E-Mail address of the account |
mail.password | Password of the account |
mail.tls | Activate if the communication with your E-Mail Server is secured. |
properties.mail.smtp.from | If your mail server allows it, you can overwrite the from value. NOT RECOMMENDED |
properties.mail.smtp.auth | Authentication is needed, therefore usually |
properties.mail.smtp.starttls.enable | Usually |
Changing the SMTP configuration requires a backend restart.
The best way to test your settings is to use the “Invite User” feature from the user administration area.
In case of an error, please check the backend logs for further analysis.
Configuration Examples
These examples help you to set up your SMTP connections.
Sendinblue
After you have set up your Sendinblue account, you can use the following configuration.
Look up the “SMTP key” inside your account settings of sendinblue and use this as password in the configuration of portrait:
spring:
mail:
host: smtp-relay.sendinblue.com
port: 587
username: no-reply@customer.com
password: 'your-secret-smtp-key'
tls: true
properties.mail.smtp:
from:
auth: true
starttls.enable: true