Tutorial

Ghost SMTP Setup for Transactional Email

Fix magic links, member signups and staff invites on self-hosted Ghost with one config block.

By the Sendcorex team·Updated Nov 18, 2026·4 min read

Two kinds of email in Ghost: transactional email (magic links, member signups, staff invites, password resets) uses the mail settings below. Newsletters are bulk email and are configured separately in Ghost's newsletter settings.

1. Edit config.production.json

"mail": {
  "transport": "SMTP",
  "from": "Acme <hello@yourdomain.com>",
  "options": {
    "host": "smtp.sendcorex.com",
    "port": 587,
    "secure": false,
    "auth": {
      "user": "YOUR_SENDCOREX_API_KEY",
      "pass": "YOUR_SENDCOREX_API_KEY"
    }
  }
}

Keep "secure": false on port 587 (STARTTLS is used automatically). For port 465 set it to true.

2. Restart Ghost

ghost restart

Then invite a staff user or sign up as a member to test. If nothing arrives, run ghost log to see the SMTP error.

3. Authenticate your domain

The from address must be on a domain with SPF, DKIM and DMARC. Magic-link emails are time-sensitive: if they land in spam, members can't log in. Verify with the SPF, DKIM and DMARC checker.

Frequently asked questions

Why is Ghost not sending magic link emails?

Self-hosted Ghost has no working mail transport by default. Add the SMTP block to config.production.json, restart Ghost and check ghost log for errors.

Make Ghost emails arrive

Create a free account, verify your domain and paste in the config above.

No credit card required