Email
mddb sends email through an SMTP server that you choose. Without SMTP, accounts and invitations still work, but nobody receives messages.
mddb sends three kinds of messages
- Verification links for new accounts and changed email addresses.
- Organization invitations.
- Workspace invitations.
Links in each message start with server.base_url.
Configure SMTP on the server settings page
- Sign in as the server administrator, the first account on the server.
- Open
<base_url>/settings/server. - Under SMTP Configuration, enter the host, port, username, password, and from address.
- Save, then restart the service.
mddb stores these values in settings.json in the config directory. The page never shows the stored password. Leave the password field empty to keep it. mddb authenticates with the username and password, so both are required.
The SMTP server must offer STARTTLS
mddb connects with plain TCP, then upgrades with STARTTLS and requires TLS 1.2 or later. Use your provider's submission port, usually 587. Implicit TLS on port 465 does not work.
Changes apply at startup
mddb builds its mail client when it starts. A saved SMTP change takes effect after the next restart.