Browse documentation
Email (SMTP) setup
For email notifications to work, JOATOS needs an SMTP server to send through. You configure this once per organisation.
Configuring SMTP
In Settings, under Alerts, open Email Server.
Choosing a provider
First choose how mail is sent:
- SMTP — a normal mail server. Fill in the fields below.
- Resend (HTTPS API) — sends over HTTPS instead of SMTP, so it works on hosts that block the outbound SMTP ports. It needs a Resend API key, and the From domain must be verified in Resend.
If test emails time out and your host blocks ports 25, 465 and 587 — common on cloud providers — Resend is the answer, not a different SMTP port.
SMTP settings
| Field | Notes |
|---|---|
| Host | Your SMTP server, e.g. smtp.example.com |
| Port | Default 587 |
| Encryption | STARTTLS (default), TLS / SSL, or None |
| Authentication | Username & Password, or None |
| Username | Shown when authentication is on |
| Password | Shown when authentication is on; stored encrypted |
| From Address | The address alerts are sent from, e.g. alerts@example.com |
| From Name | Display name, e.g. JOATOS Alerts (optional) |
Select Save.
Sending a test email
After saving, select Send test email. JOATOS sends a test message to your own logged-in email address, so you can confirm the settings work. The button is disabled until a configuration has been saved.
How the password is handled
Once saved, the password field shows a placeholder (••••••••) rather than the real value. Saving again with the placeholder unchanged keeps the existing password; type a new value to replace it. Passwords are always encrypted at rest — never stored in plain text.
Notes & tips
- SMTP is per organisation — one mail configuration serves all email notification profiles.
- Without a working SMTP config, email notification profiles can't send; those attempts appear in the alert history with a No SMTP status.