Developer docs

Why do I have to set up Mailgun?

Ghost has the ability to deliver posts as email newsletters natively. A bulk-mail provider is required to use this feature and SMTP cannot be used — read more about mail config.

Sending mail in Ghost

Transactional email in Ghost can be configured to send with any SMTP, or another mail service that you prefer, using Ghost’s standard configuration setup.

Bulk email delivery for newsletters is a new feature which requires a bulk mail API. Currently the only bulk mail API we support is Mailgun.

If you don’t want to deliver posts to members by email, you do not need a Mailgun account and you can safely ignore the email newsletter settings completely!

Why can’t I just use SMTP mail config to send email newsletters with Ghost?

Sending a bulk email to many recipients using basic SMTP will result in your IP address being instantly blacklisted and marked as spam by all mail providers. You should never, ever send bulk mail using basic SMTP, which is why Ghost does not support it.

More info here, and here, and here, and here.

Did you know Mailgun doesn’t have free accounts anymore??

Mailgun recently updated their pricing, including the removal of a free tier. However, under their new pricing, invoices are not sent if they total less than $0.50 - which is still more than 600 emails. For most people who are getting started Mailgun remains free, and subsequent rates are extremely generous. It would cost far, far more (money as well as time) to run your own bulk mail delivery infrastructure, or use most other providers.

I still want to use a different provider to send email newsletters, why can’t I do that?

You can. There is no requirement to use Ghost’s built in newsletter delivery feature. Before we released this feature, thousands of people sent their newsletter using all sorts of other services such as Mailchimp, Sendgrid, Convertkit, and many others. You can easily sync your members database to an external newsletter provider via Zapier, or by following our detailed integration guides.

Do you have any affiliation with Mailgun? Are you on their referral program or something?

No. We have no partnership with Mailgun, we are not on their referral or affiliate program, they do not provide us with free service, and we do not benefit in any way (financial or otherwise) from people using them. We pay full-price for our own Mailgun account

I am OUTRAGED by this explanation

Some people seem to experience a bizarre amount of anger about email configuration for reasons which are very difficult to decypher.

Fortunately, Ghost is open source — so if our many years of tireless work to make a great product don’t meet your exacting standards for free software — you can always fork the codebase and modify it to work however you would prefer.