How do I set up a custom domain for my status page?

Every Oh Dear status page is accessible on a URL like ohdear.app/status-page/{slug} by default. To point it at your own domain (for example status.yourcompany.com) you need to do two things: configure the domain in your Oh Dear status page settings, and add a DNS record.

Configure the custom domain in Oh Dear #

1. Open your status page's Settings tab.
2. Under Custom domain, enter the subdomain you want to use (status.yourcompany.com).
3. Save.

Add the CNAME record in your DNS #

After you save, the settings page shows the exact record to add. Every status page gets its own target, so the record looks like this, with your page's own code in front:

status.yourcompany.com.   CNAME   k7x2p9mq4a1b3c5d.status.ssl.ohdear.app.

Copy the value from your settings page, not the one above. That record sends your visitors to us, and it also proves the domain is yours. We only issue a certificate and show your status page once we've seen it.

Why a unique target? If you ever delete your status page and forget to remove the DNS record, nobody else can claim your domain on Oh Dear. Your old record points at a target that only your page ever owned.

Give DNS a few minutes (or an hour, depending on your provider) to propagate. We check for the record every 10 minutes for 7 days after you set the domain, or you can hit Check now on the settings page. Once it's verified, Oh Dear automatically provisions a Let's Encrypt TLS certificate for your custom domain. You don't need to supply one.

Can't use a CNAME? #

Sometimes we can't see your CNAME, for example when Cloudflare proxies the record or when you point an A record at us. Then add a TXT record as well. The settings page shows its exact name and value:

_ohdear-challenge.status.yourcompany.com.   TXT   "ohdear-verify=k7x2p9mq4a1b3c5d"

Already verified your domain under verified domains in your team settings? Then status pages on that domain and its subdomains are verified too.

Troubleshooting status page custom domain issues #

• "We don't see the record yet": the record isn't in place yet, or your DNS provider is still propagating. Try dig status.yourcompany.com CNAME and check it returns the exact target from your settings page. A CNAME to plain status.ssl.ohdear.app doesn't verify your domain.
• Certificate never issues: we only request a certificate once your domain is verified. Check the status on your settings page first. If it still doesn't work after a few hours, contact support.
• Apex domain (no subdomain): many DNS providers don't allow CNAMEs on apex domains (yourcompany.com with no subdomain). Use a subdomain like status.yourcompany.com, which is the standard pattern anyway. If your provider supports ALIAS or ANAME records, those work too, together with the TXT record above.

Full documentation: Add a custom domain to your Oh Dear status page.

Status pages through Cloudflare #

We also support Cloudflare in front of our status pages, for a detailed guide on that, we'll refer to our How do I put Cloudflare in front of my status page? page.