Email delivery mode

How the script sends mail: Sendmail, SMTP, or Gmail (XOAUTH2). Fix this before requiring verification.

Settingemail_mode

Email delivery mode

Controls how transactional mail leaves the server: verification, password resets, tickets, notices, and tests.

Where to find it

Admin → Settings → Settings (first tab) → Email delivery → Email delivery mode (Provider)

Setting key: email_mode

Options

Value Mode What you need
sendmail Sendmail Local MTA / sendmail binary from install — no SMTP creds
smtp SMTP Server, port, user, password, TLS — see SMTP settings
gmail Gmail OAuth client ID/secret + Connect Google — see Gmail XOAUTH2

Unknown/empty values can fall back oddly (mailer may treat unknown as SMTP while the picker leans sendmail) — always save an explicit mode.

How it works

Pick one mode, fill that mode’s fields, save, then send a test (tests typically go to Contact email). Until this works, Require email verification traps new users.

Also set Email from address so the From header matches a domain you are allowed to send as.

Common problems

Mode is SMTP but fields are empty

Nothing useful will send. Fill SMTP settings or switch mode.

Switched to Gmail without OAuth

Gmail mode needs client ID/secret and a completed Connect Google flow — not a Gmail password.

Related