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

Relabeling/Private Labeling The Mailgun SMTP Hostname

Quick Overview

It is possible to relabel/private label Mailgun's SMTP hostname to values other than smtp.mailgun.org (US region) or smtp.eu.mailgun.org (EU region) through the creation of a CNAME record.

However, we do not recommend this configuration due to a flaw inherent in such an approach.

Understanding The Context

Setting The Scene

Sometimes companies prefer to hide third-party services from their customers.  While rarely inquired, once-in-a-while a company using Mailgun would prefer to hide the Mailgun brand from their customers. This process of achieving this goal of hiding a third-party service is called relabeling or private labeling

This process utilizes a CNAME record configured within the DNS settings of your sending domain. The record's value points to one of the region-specific, Mailgun SMTP hostnames.  However, there is an important caveat to be aware of before deciding to implement this configuration.

Discerning The Nuance

The caveat is that connections from the device sending the email to Mailgun must be unencrypted when relying upon this approach.  It does not apply to connections from Mailgun to a receiving email server. 

The SSL certificates for encrypted connections on our servers are configured for *.mailgun.org  What this means is any encrypted connection over our allowed ports (i.e. 25, 465, 587, and 2525) will fail due to a mismatch between your hostname and *.mailgun.org

To reiterate, the above concerns only connections from the sending device to Mailgun's servers. 

After Mailgun receives and processes any requests received through those connections, then Mailgun establishes opportunistic TLS connections (by default) from Mailgun's servers to a recipient's email server.  For more information concerning this behavior and how to adjust it, please see our Mailgun documentation.

Implementing The Solution

Adding The CNAME Record

While the process for creating a CNAME varies among DNS providers, creating this CNAME is no different procedurally than creating any other CNAME within your particular DNS provider's system.  

The record's hostname would be the (sub)domain that you would like your customers to use in their SMTP applications. The record's value will need to point to the region where your Mailgun domain exists: either smtp.mailgun.org for domains created in the US or smtp.eu.mailgun.org for domains created in the EU.  

Configuring The SMTP Application

Your customers' SMTP applications would need to use one of these ports (25, 587, or 2525) with no encryption selected. Further, the SMTP hostname field in the application would use the hostname of your (sub)domain's new CNAME record.

As a note: under ordinary circumstances (i.e. not the exceptional circumstance explored by this article), port 465 requires TLS while ports 25, 587, and 2525 allow either a non-TLS connection or a connection upgraded to TLS by use of the STARTTLS command.

Got Questions?

Mailgun by Pathwire has answers! If you still have any concerns or questions, please send us a Support ticket through the Support page within your Mailgun Control Panel.  Our Support Team will be happy to assist! 

Powered by Zendesk