Skip to main content
The Mail server page sets how OASM sends email. Today it sends the verification emails of public sign-up, which stays closed while the mail server is off. The page lives in the console’s Admin area under System → Mail server (/admin/mail-server).
Available from v0.10.0. Only users with the platform Admin role can change it — see Users and roles.

Providers

OASM sends every email over SMTP. Most email services offer an SMTP relay, so picking a provider fills in its host, port, and TLS setting, and the username where the service expects a fixed one. You usually only paste a key.
For Mailgun, use smtp.eu.mailgun.org for domains in the EU region. For Amazon SES, change the region in the host to match yours. Gmail needs 2-Step Verification and an app password.

Set up the mail server

1

Open the page

Open the user menu, choose Admin, then Mail server under System.
2

Pick a provider

Choose one under Provider. Every field stays editable, for example to change a region in the host.
3

Fill in the credentials

Enter the username and the password or API key. Implicit TLS is usually on for port 465; off uses STARTTLS, usually on port 587.
4

Set the sender

Sender email is the From address; your provider must allow sending from it. Sender name defaults to the platform name — see Brand name and logo.
5

Turn it on and save

Switch on Turn on mail server and click Save. Turning it on needs a host and a sender email.
6

Send a test email

Under Send a test email, check the address (your own by default) and click Send test email. If the server refuses, the error says why, for example Invalid login: 535 Bad credentials.
The password or API key is stored encrypted with your encryption keys and never sent back to the console: the field shows “Saved; leave empty to keep it”. Leave it empty to keep the saved one, or type a new one to replace it. Changes apply to the next email, with no restart.

Troubleshooting

The username or password is wrong for this provider. For API-key providers, check that the key has SMTP or sending permission; for Gmail, use an app password, not the account password.
The host or port is unreachable from the server — some cloud providers block outgoing SMTP ports. Check the host and port, try 587 instead of 465 (or the reverse, switching Implicit TLS to match), or ask your hosting provider to open the port.
Send from a domain you control and set up SPF, DKIM, and DMARC for it as your provider describes. A sender address on a free mailbox domain is often marked as spam.
It uses the saved settings, so save your changes and turn the mail server on first.

Authentication

Open public sign-up once the mail server works

Deployment

BASE_URL and the encryption keys that protect the saved password