SMTP settings
SMTP server, port, username, password, and Encrypt connection (TLS) for outbound mail.
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.