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 and fill in:
| 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.