Skip to content

[mail]

SMTP server for sign-in links, invitations and notifications.

Key Type Default Description
mail.enabled bool enabled overrides the legacy “configured host means enabled” rule. A pointer preserves old files without an enabled key while allowing the console overlay to disable a [mail] table in the operator’s file.
mail.host string host is the SMTP server name. A configured host enables mail unless enabled = false.
mail.port integer 0 port of the SMTP server; 0 uses 587 for starttls and 465 for tls.
mail.security string security is “starttls” (upgrade a plain connection, port 587) or “tls” (TLS from the first byte, port 465). There is no plaintext mode.
mail.sender string sender is the From address.
mail.username string username for SMTP authentication.
mail.password_env string password_env names the environment variable holding the SMTP password. The password itself never sits in configuration.
mail.link_base_url string link_base_url is the console address that emailed links point to, for example https://prism.example.net:18081. It is fixed here rather than taken from the request, so a forged host header cannot redirect a sign-in link to another site.