Mail Server
Tramola sends mail for a handful of account tasks. Without an SMTP server configured, none of them work.
What Tramola sends mail for Link to this section
| Occasion | |
|---|---|
| A user registers themselves | a welcome mail with a link to set their own password |
| A user forgot their password | a link to reset it |
| A user adds an email address | a link to verify that it is theirs |
| An administrator tests these settings | a test message |
That is the whole list: mail is for getting into an account and for proving an address belongs to somebody. Two things it is explicitly not for:
- Runs. Tramola does not mail when a run finishes; that is reported in the interface.
- Accounts an administrator creates. Those get no mail at all — the administrator passes the password on directly. See Accounts.
If no mail server is configured, users cannot reset their own passwords and cannot verify an email address. An administrator can still overwrite a password directly, so an installation without mail is usable — but every forgotten password becomes an administrator’s job. See Accounts.
Configuring it Link to this section
Open .
| Field | Meaning |
|---|---|
| Sender Email Address | The address mail from this instance is sent from. Use one the mail server is actually allowed to send as, otherwise the mail will be rejected or treated as spam. |
| SMTP Server | Hostname of the mail server, e.g. smtp.example.com. |
| Use SMTP Authentication | Whether to sign in to the mail server. Off only makes sense for a server that accepts unauthenticated mail from this machine. |
| User Name and Password | The credentials for that sign-in. Only editable when authentication is switched on. |
| Use SSL | Whether to connect over SSL/TLS. |
| SMTP Port | The port. 465 for SSL, 587 for submission with STARTTLS, 25 for a plain local relay — follow what your mail server expects. |
Click when done.
Testing it Link to this section
Do not wait for the first user to find out whether mail works. Enter an address you can read under Test recipient and click . Tramola sends a real message to that address and reports either that it went out or why it did not.
Test after every change. A wrong port or a rejected sender is invisible in normal operation — Tramola tries to send and the mail quietly never arrives.
Certificate verification Link to this section
By default Tramola verifies the mail server’s TLS certificate and refuses to connect if it does not check out. A server with a self-signed or otherwise untrusted certificate will therefore fail to connect.
The check can be switched off in the configuration file:
tramola.email.smtp.verifyCertificates = false
Switching this off means the connection can no longer be trusted to reach the server you think it does, and the credentials above are sent over it. Prefer fixing the certificate — by installing the issuing CA on the Tramola machine, or by using a server with a certificate that validates.
Where the settings are stored Link to this section
Sender address, server, port and authentication settings are stored in Tramola’s database and
edited in the interface — they are not part of conf/tramola.conf. Only
verifyCertificates is a configuration-file setting.