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:

  1. Check the spam folder and your relay's logs. The product records only that it handed the message over.
  2. Check the sender. Many relays reject a SMTP_FROM they do not own.
  3. 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.