Email (planned)
Planned. Self-hosted deployment is not available yet. The settings below are what the product reads today.
A self-hosted deployment sends its own email through your mail relay. Nothing is sent through Provantix.
What email is used for
- Sign-in codes: a person signs in with a password and a one-time code sent by email.
- Invitations and set-password links from an administrator.
- Alert emails for findings (see Alerts).
- Notices such as the sealing deadline reminders.
Because sign-in codes arrive by email, a self-hosted install is not usable until email works, unless everyone signs in through your identity provider. The installer's preflight tests the relay and will not finish without a working one or an explicit choice to skip.
Settings
Put these in the settings file and restart the service:
SMTP_HOST=smtp.corp.example.com
SMTP_PORT=587
SMTP_USER=provantix-mailer
SMTP_PASS=...
SMTP_FROM="Provantix <[email protected]>"
| Setting | Meaning |
|---|---|
SMTP_HOST |
The relay's hostname. |
SMTP_PORT |
587 (STARTTLS, the default) or 465 (implicit TLS). |
SMTP_USER, SMTP_PASS |
Credentials for the relay. Both are required: the mailer is off unless host, user and password are all set. |
SMTP_FROM |
The sender address and name. Defaults to the user name if unset. Use an address your relay allows and your recipients' filters accept. |
A relay that accepts mail without a login is not supported by the first release; use a service account.
Check it
nc -vz smtp.corp.example.com 587 # the port is reachable
sudo systemctl restart provantix
journalctl -u provantix -n 30 --no-pager | grep -i mail
Expect [mail] SMTP configured (smtp.corp.example.com:587). If you see SMTP not configured, one of host, user or password is missing.
Then ask an administrator to invite a test address and confirm the message arrives. If it does not:
- Check the spam folder and your relay's logs. The product records only that it handed the message over.
- Check the sender. Many relays reject a
SMTP_FROMthey do not own. - Check the certificate. If your relay uses a certificate from an internal authority, the service must trust it. Add the authority to the machine's trust store and restart.
When mail is not configured
Nothing fails silently: each message is written to the service log instead of being sent, with any six-digit code removed from the logged text. That is for diagnosis, not for use: people will not receive their codes.