• Email DIY

Migrating From The Heroku Mandrill Add-On To The Mailgun Add-On

Josh Odom
5 min read

This post was originally published on February 29, 2016.

With Mandrill announcing that the Heroku add-on is no longer going to be available after April 25th, many developers are looking for an alternative solution that they can continue using from the Heroku Marketplace.

Mailgun offers several different packaged add-ons that you can select from based on the volume of e-mail you send on a monthly basis. You can upgrade to a larger plan at any time or if you need something specific to your needs, a program can be custom tailored for you.

Install the Mailgun Add-on

The free starter plan can be easily installed on your application by running the following Heroku CLI command from your application’s folder:

heroku addons:create mailgun:starter

The starter plan includes 400 messages per day and is perfect to get started with.

Setting up Mailgun

You can open the Mailgun dashboard by running the following command:

heroku addons:open mailgun

When Mailgun is provisioned, a sandbox domain is automatically configured that can be used for testing Mailgun without setting up a custom domain. The sandbox domain is limited to 300 messages a day and is not optimized for deliverability.

For production use, setting up a custom domain is the best option. In the Mailgun dashboard, click the Add Custom Domain button.

Update DNS

After setting up your domain, you’ll be given a set of DNS records that need to be added to your DNS provider before your domain can be used. Setting up these records enable SPF, DKIM, incoming messages, and message tracking.

Once the records are in place, you can wait for automatic validation to occur or click the Check DNS Records Now button to force an immediate check.

Updating Your Applications

At this point, you’re ready to update your application to use the Mailgun addon. If you’re using a library that uses SMTP, you can update your application’s configuration to the following:

SMTP Hostname: smtp.mailgun.org Port: 587 Username: See Default SMTP Username on Mailgun domain page Password: See Default Password on your Mailgun domain page

If you’re using a Mandrill library, you will need to migrate to a Mailgun-specific library or a library that is SMTP compatible. We have code samples for most major languages.

Need Help?

Our team is available 24/7/365 to help make sure you have a successful transition to Mailgun. From the Mailgun dashboard, click the Support button to access our help center or create a support ticket.

Last updated on September 16, 2020

  • Related posts
  • Recent posts
  • Top posts
View all

Always be in the know and grab free email resources!

No spam, ever. Only musings and writings from the Mailgun team.

By sending this form, I agree that Mailgun may contact me and process my data in accordance with its Privacy Policy.

sign up
It's easy to get started. And it's free.
See what you can accomplish with the world's best email delivery platform.
Sign up for Free