Towbar uses one SMTP connection for operational notifications and account messages such as invitations, password resets, and email-change confirmation. The connection belongs in the protected control-plane YAML file; operational recipients are managed in the dashboard.
Prepare an SMTP account
Get a public SMTP hostname, port, sender address, and credentials from your mail provider. Authorize the sender identity with that provider and confirm that the account can send to the intended recipients. Towbar rejects SMTP hosts that resolve to private or reserved addresses. Choose the provider’s TLS mode: for a provider that offers STARTTLS on port 587, use secure: false; for implicit TLS on port 465, use secure: true.
Run sudo towbar config validate, then sudo towbar restart. Open Manage → Notifications → Email. The destination controls appear only when SMTP is configured.
Add and test a recipient
Choose Add email, enter an operational recipient, and select its Deployments, Backup & Restore, and Alerts & Incidents subscriptions. Preview events follow Deployments. Checkbox changes save immediately. Use the test action on that row and confirm that the provider accepted the sample message; then check the recipient mailbox. Account messages go to the affected account independently of this operational destination list.
If testing fails, check the sender identity, SMTP authentication, TLS mode, host resolution, and the delivery result. A provider acceptance does not guarantee inbox placement. Rotate a credential in YAML, validate and restart, send a test message, and only then revoke the previous credential.
Email destinations and their category subscriptions appear here once SMTP is
configured.