Overview
This guide demonstrates how to add a root domain or subdomain to DigitalOcean and configure the (sub)domain with each Mailgun DNS record. This guide assumes that you have already created your DigitalOcean account.
While this guide is intended to be as helpful and comprehensive as possible, there is a small possibility that you will encounter an error or issue of some kind while configuring your DNS records within DigitalOcean. If that is the case, we recommend contacting DigitalOcean's Support Team as they will be able to most quickly identify and resolve the issue (or, at minimum, provide next steps).
Deciding between a root domain or subdomain
Deciding which domain to use - especially whether to use your root domain or a subdomain of that root domain - is key before proceeding any further. As this can be a challenging decision to make, we recommend reviewing the following Mailgun articles if needed:
- Choosing a domain name
- The basics of email subdomains
- Can I use the same domain name for Mailgun and my personal email account?
Nevertheless, let's briefly review two key terms: root domains and subdomains.
Examples of root domains include mailgun.com, mydnsexample.com, or google.com. Examples of subdomains include relay.mailgun.com, mg.mydnsexample.com, or mail.google.com. Notice the pattern: subdomains have an extra prefix (or sometimes multiple prefixes) before the primary domain name itself. In most cases using a subdomain with Mailgun is preferred, but we cover this topic more comprehensively in the above articles.
Finally, once a decision has been reached, add the (sub)domain to your Mailgun account, and our system will generate the various DNS records needed . We cover adding (and deleting) domains in detail within this in-depth guide.
Adding and configuring the domain
Adding a (sub)domain within the DigitalOcean Control Panel only takes 3 steps, and the steps to access an existing domain are virtually identical (except for the last step where instead of creating a new domain you'll click the existing domain). We will list those steps below, but if desired, you can also reference DigitalOcean's Add A Domain and Add A Subdomain To Your Domain articles.
This guide does not cover creating and managing DigitalOcean projects, but you can find more information in DigitalOcean's Project documentation, if needed.
Tip: For larger images, right-click and select the option "Open Image in New Tab" (or Window).
-
Login to your account.
-
Click the Networking option on the left-hand navigation pane.
-
Type a domain name in the text field and choose a project from the drop-down. Finally, click the Add Domain button.
Configuring SPF
SPF records help protect your domain against spoofed emails and decrease* the likelihood your emails will be flagged as spam. (* Exceptions apply: e.g. actual spam/phishing emails will still be considered as such by mailbox providers even with the presence of an SPF record.)
Additionally to our guide, DigitalOcean does provide their own SPF tutorial. Interested in more extensive technical details concerning SPF records? Please reference this Mailgun article, RFC 7208, or DigitalOcean's SPF technical documentation.
Tip: For larger images, right-click and select the option "Open Image in New Tab" (or Window).
Configuring a root domain with the SPF record
Within your DigitalOcean Control Panel, enter the SPF record information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example domain called mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Value |
v=spf1 include:mailgun.org ~all Notes:
|
Hostname |
@ Notes:
|
TTL (Seconds) |
300 Notes:
|
Configuring a subdomain with the SPF record
Within your DigitalOcean Control Panel, enter the SPF record information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example subdomain called mg.mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Value |
v=spf1 include:mailgun.org ~all Notes:
|
Hostname |
mg Notes:
|
TTL (Seconds) |
300 Notes:
|
Configuring DKIM
DKIM records help authenticate your domain against forged emails and decrease* the likelihood your emails will be flagged as spam. (* Exceptions apply: e.g. actual spam/phishing emails will still be considered as such by mailbox providers even with the presence of an DKIM record.)
Additionally to our guide, DigitalOcean does provide their own DKIM tutorial. Interested in more extensive technical details concerning DKIM records? Please reference this Mailgun article or RFC 6376.
Tip: For larger images, right-click and select the option "Open Image in New Tab" (or Window).
Configuring a root domain with the DKIM record
Within your DigitalOcean Control Panel, enter the DKIM record information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example domain called mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Value |
k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUA Notes:
|
Hostname |
pic._domainkey Notes:
|
TTL (Seconds) |
300 Notes:
|
Configuring a subdomain with the DKIM record
Within your DigitalOcean Control Panel, enter the DKIM record information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example subdomain called mg.mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Value |
k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUA Notes:
|
Hostname |
pic._domainkey.mg Notes:
|
TTL (Seconds) |
300 Notes:
|
Configuring MX
MX records describe where emails intended for your domain should be sent.
Additionally to our guide, DigitalOcean does provide their own MX tutorial. Interested in more extensive technical details concerning MX records? Please reference RFC 5321.
Tip: For larger images, right-click and select the option "Open Image in New Tab" (or Window).
Configuring a root domain with the MX records
Within your DigitalOcean Control Panel, enter the MX records information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example domain called mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Hostname |
@ Notes:
|
Mail Providers Mail Server |
mxa.mailgun.org mxb.mailgun.org Notes:
|
Priority |
10 Notes:
|
TTL (Seconds) |
300 Notes:
|
Configuring a subdomain with the MX records
Within your DigitalOcean Control Panel, enter the MX records information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example subdomain called mg.mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Hostname |
mg Notes:
|
Mail Providers Mail Server |
mxa.mailgun.org mxb.mailgun.org Notes:
|
Priority |
10 Notes:
|
TTL (Seconds) |
300 Notes:
|
Configuring CNAME
CNAME records alias (point or direct) one domain name to another domain name, which in this case effectively associates your emails with Mailgun and allows tracking of opens and clicks.
Additionally to our guide, DigitalOcean does provide their own CNAME tutorial. Interested in more extensive technical details concerning CNAME records? Please reference RFC 1034.
Tip: For larger images, right-click and select the option "Open Image in New Tab" (or Window).
Configuring a root domain with the CNAME record
Within your DigitalOcean Control Panel, enter the CNAME record information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example domain called mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Hostname |
Notes:
|
Is An Alias Of |
mailgun.org Notes:
|
TTL (Seconds) |
300 Notes:
|
Configuring a subdomain with the CNAME record
Within your DigitalOcean Control Panel, enter the CNAME record information that is displayed in your Mailgun Control Panel. (In the Mailgun Control Panel, you'll click on the Sending option followed by the Domain settings suboption found within in the left-hand navigation pane, and then click on the DNS records tab).
Both the image above and the table below - using an example subdomain called mg.mydnsexample.com - provide additional guidance for adapting certain values (such as the Hostname) into DigitalOcean's system. Other DNS nuances and problematic scenarios that you may encounter are also explained in detail. Generally, the bolded-in-blue-text within the table can be copied-and-pasted for each field, unless it is noted otherwise (such as the DKIM value, which is unique for every Mailgun domain).
Field | Enter |
---|---|
Hostname |
email.mg Notes:
|
Is An Alias Of |
mailgun.org Notes:
|
TTL (Seconds) |
300 Notes:
|
The domain registrar and nameserver records
A somewhat common situation we witness concerns a customer having recently migrated (or currently being in the process of migrating) from one DNS hosting provider to another; however, their Mailgun DNS records are failing to verify within their Mailgun Control Panel. Perhaps you yourself are experiencing this exact situation. If so, there is a solution: update the domain's registration information.
Whenever anyone switches DNS hosting providers (e.g. from Google Domains to DigitalOcean), they must also update their Nameserver (NS) records within their Registrar's system. Your Registrar is the company through whom you purchased the domain and with whom the domain is registered on the Internet. As a note, DigitalOcean is not a Domain Registrar.
If you need assistance identifying the Registrar for your domain, the ICANN WHOIS website can assist you in this task. Alternatively, you can use a MacOS/Linux terminal to obtain this information:
Scan the output results for the line that contains the Registrar URL information. It is this field that will identify the domain's Registrar and their website.
For more guidance on updating your registrar and nameserver records to reflect your DNS hosting with DigitalOcean, please review DigitalOcean's comprehensive documentation. Additionally, if you're experiencing a domain registration issue, it is best to reach out to the Registrar directly. Mailgun, in such a scenario, would not have any insight additional to the publicly available WHOIS information mentioned above.
Need Support?
Our Support Team here at Sinch Mailgun is happy to help! Reach out to us in the Support page of your Mailgun Control Panel, and we'll be with you shortly!