SMTP settings
When Email delivery mode is SMTP, these fields talk to your mail provider.
Where to find it
Admin → Settings → Settings (first tab) → Email delivery (mode SMTP)
| Field (UI) | Key |
|---|---|
| SMTP server | smtp_server |
| SMTP port | smtp_port (default often 587) |
| SMTP username | smtp_user |
| SMTP password | smtp_pass (blank on save usually keeps the existing secret) |
| Encrypt connection (TLS) | smtp_use_tls |
There is no separate smtp_secure / smtp_auth key in current builds — use smtp_use_tls.
How it works
Typical patterns (confirm in your provider’s docs):
- Port 587 + TLS/STARTTLS on (
smtp_use_tlson) - Port 465 → script uses implicit SSL (
secure: true); UI TLS is often off for 465 - Username is often the full mailbox address
Official provider docs (Mailgun, Amazon SES, your host, etc.) show the exact host/port and whether you need an app password.
Email from address should be a From your SMTP account is allowed to send as (SPF/DKIM). The script does not hard-validate that match — spam filters do.
Common problems
Authentication failed
Wrong password, or the provider wants an app password. Re-copy from the provider dashboard.
Connection timeout
Firewall blocking outbound 587/465, or wrong host. Test from the VPS.
TLS / handshake errors
Align port + Encrypt connection (TLS) with the provider. 587 vs 465 mismatch is the usual cause.