Vanity Domain Setup¶
A vanity domain lets your users reach Mythradon at a web address on a domain you own, such as crm.example.com.
You must own the domain. If you do not have one, buy one from a domain registrar first. You then point a hostname on it at Mythradon by adding DNS records. Mythradon issues the TLS certificate for the hostname, and email can be sent from it.
This is different from Domain Setup and Verification, which lets Mythradon send email from a domain you already use for email.
Note
You need access to your domain's DNS settings, usually through your domain registrar or DNS provider. If someone else manages your DNS, such as your IT provider, they will need to add the records. Mythradon supplies the name and value of every record.
Overview¶
| Who | Responsibility |
|---|---|
| You | Own the domain and manage its DNS. Choose the hostname, add the DNS records Mythradon sends you, and make sure the domain has a DMARC record. |
| Mythradon | Sets up the hostname on the platform, sends you the DNS records to add, issues and renews the TLS certificate, and tells you when the hostname is live. |
Follow the steps below in order. Some steps wait on Mythradon. They are marked What happens next.
Step 1 - Request your vanity domain¶
Contact Mythradon Support with the hostname you want to use, such as crm.example.com. The domain must already be registered to you, and you must be able to edit its DNS.
What happens next
Mythradon sets up the hostname on the platform and sends you the DNS records to add in Step 2. Wait for these before continuing.
Step 2 - Publish the DNS records¶
In your domain's DNS, add the records Mythradon sends you. The CNAME record points your hostname at Mythradon. The certificate validation records prove you control the hostname, so the TLS certificate can be issued. The email records let email be sent from it. They look like this:
| Purpose | Type | Name (example) | Value |
|---|---|---|---|
| Web routing | CNAME | crm |
provided by Mythradon |
| Certificate validation | TXT | _cf-custom-hostname.crm |
provided by Mythradon |
| Certificate validation | TXT | _acme-challenge.crm |
provided by Mythradon. There may be two values; add both. |
| Email signing (DKIM) | CNAME | default._domainkey.crm |
provided by Mythradon |
| Email authorisation | TXT | _mailchannels.crm |
provided by Mythradon |
Note
The example names above use crm, the first part of crm.example.com. Substitute your own vanity label. Copy each name and value exactly as sent. A single wrong character stops the domain from going live or stops email from being delivered.
Email records are optional
The Email signing (DKIM) and Email authorisation records are needed only if Mythradon will send email from your vanity hostname. If it will not, tell Mythradon Support and leave these two records out.
Step 3 - Confirm your DMARC record¶
DMARC is a DNS record that tells email providers how to treat mail sent from your domain. It is published once on your organisational domain, not on the vanity hostname: for crm.example.com, the record is _dmarc.example.com. Most domains already have one. If yours does not, add one, or your email may be treated as spam.
You or your IT provider manage this record. Mythradon does not create or change it. A simple starting value:
You can tighten the policy (for example to p=quarantine or p=reject) later, once you are satisfied your mail is authenticating correctly.
Step 4 - Tell Mythradon you're done¶
Once the records from Step 2 are added, tell Mythradon Support.
What happens next
Mythradon checks your records and issues your TLS certificate. If Mythradon will send email from the hostname, a test email is sent too. DNS changes can take a while to take effect, so this may not happen straight away. Mythradon Support will tell you when your hostname is live.
What Mythradon handles¶
- TLS certificate - Mythradon issues and renews it. You do not need web hosting or a certificate of your own.
- SPF - Mythradon handles SPF for the vanity hostname. You do not add an SPF record for it.
- Ownership check - The records in Step 2 confirm you own the domain. There is no file to upload or verification code to enter.