We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

Can I Migrate My Domain to EU?

Why yes - you can certainly migrate your domain from the US to the EU!

Whether you're looking to implement a fully GDPR-compliant configuration for your Mailgun account, or just have your messages sent from a data center closer to home, here are the steps you need for getting your domain setup modified from the US to the EU region. 

More general info on our EU region in our blog post here

Action Plan for Migration

There are two options to transfer a domain between US and EU regions. The action plan would depend on two elements: 1. Your use case, and 2. Your desired final configuration.

Option 1: Using a Subdomain

First, we know that moving your currently configured domain to a new region can cause service disruptions; without planning, it's just deletion from one region and addition in the other. However, you could create a new subdomain in the EU region instead to potentially avoid this. Having one domain in the US region and another in the EU region allows for you to split your sending between the regions.

  1. Only in the classic UI - you first need to navigate to the EU portal by selecting the EU flag on the top-right dropdown menu. Your current region dashboard can be identified by the small flag icon in the upper right-hand corner. 

  2. If you are using the classic UI, add and verify your new EU subdomain under the Domains tab in the new EU dashboard.  Alternatively, if you are using the beta UI, click on the Messages option on the left-hand side of your Mailgun dashboard, then select Domains.

  3. While we wait for your newly added DNS records to propagate, begin exporting Mailing Lists, Routes, Suppressions, SMTP credentials, and any Webhooks from the US-hosted domain.  

  4. Verify your data is complete and import the legacy services to the EU domain and dashboard. 

  5. Finally, update your application's configuration to utilize the new SMTP information, domain SMTP credentials, and/or API endpoint.

Option 2: Transferring Domain Data - Deletion and Creation in the EU Platform

Domains are globally unique within our platform, meaning the same exact domain cannot exist in both US and EU regions. As such, if you wish to move the exact domain from the US to the EU platform, the domain would need to be deleted from the US platform first. 

Please Note When Using This Option: Once a domain is deleted, the domain data cannot be recovered. Therefore, if you required this data, you'll need to export all data before deleting the domain. Measure twice, cut once! This process is further explained below:

  1. Begin exporting all your data first; this includes items such as Mailing Lists, Routes, Webhooks, Suppressions, and SMTP credentials

  2. If you are using the classic UI, add and verify your new EU subdomain under the Domains tab in the new EU dashboard.  Alternatively, if you are using the beta UI, click on the Messages option on the left-hand side of your Mailgun dashboard and then select Domains.

  3. While the DNS records propagate, import the exported data to the newly created domain. 

  4. Once the data import is complete and the domain has been verified, update your application's configuration to utilize the new SMTP information, domain SMTP credentials, and/or API endpoint.

Exporting Data

In order to migrate your domain's data from one region to another, this data would need to be exported from the domain in the current region and imported to the domain in the new region.

Currently, through the Mailgun control panel, you can export Suppressions and Mailing Lists.

Suppressions

If you're using the classic UI (options across the top, with a silver background), use the following instructions:

  1. Click on the Suppressions tab near the top of the Mailgun dashboard.
  2. Click on the Export button for each Suppression type (Bounces, Complaints, Unsubscribes). 

If you're using the beta UI (options displayed down the left-hand side on a dark column) use these instructions:

  1. Click on the Messages option on the left-hand side of your Mailgun dashboard, then select Domains.
  2. Click on the specific domain for which you would like to view the Suppressions.
  3. You will click on the Suppressions tab near the top of the screen.
  4. Click on the Export button for each Suppression type (Bounces, Complaints, Unsubscribes).

Mailing Lists

If you're using the classic UI (options across the top, with a silver background), use the following instructions:

  1. Click on the Mailing Lists tab near the top of the Mailgun dashboard.
  2. Select the specific mailing list that you wish to export.
  3. Click on the Export Recipients button.

If you're using the beta UI (options displayed down the left-hand side on a dark column) use these instructions:

  1. Click on the Messages option on the left-hand side of your Mailgun dashboard and then select Mailing Lists.
  2. Select the specific mailing list that you wish to export.
  3. Click on the Export Recipients button.

API requests

What if you have hundreds of lists or thousands of emails you need to export? For customers interested in migrating data to the EU platform quickly, Mailgun has a full set of RESTful APIs. Below are links to our API documentation:

  1. Logs

  2. Suppressions

  3. Mailing Lists

For features such as Routes and Webhooks, these will need to be recreated within the customer UI or programmatically through the API.

Configuration Changes

Additionally, new endpoints for our services were created for the EU region as well! These changes apply to our SMTP, API, MX records, and Click tracking services. See below for these endpoints:

Service

Endpoint

RESTful API

api.eu.mailgun.net

Outgoing SMTP Server

smtp.eu.mailgun.org

Inbound MX Servers

mxa.eu.mailgun.org

Inbound MX Servers

mxb.eu.mailgun.org

Click/Open tracking

eu.mailgun.org

 

*PLEASE NOTE*: If you currently have domains in the US region and use a dedicated IP, but are migrating any or all sending to the EU and wanting to continue to use a dedicated IP, you will need to acquire an EU dedicated IP as well. Dedicated IPs are region-bound; thus specific dedicated IPs cannot be used in both regions.



If any questions arise, just reach out to our Support team via the Support tab in your Mailgun control panel!

Getting Started Sending Mail Receiving Mail Deliverability & Reputation Email Tracking Troubleshooting
Powered by Zendesk