Custom domain

On the Starter plan and above you can serve your status page from your own domain instead of livestatus.dev/your-slug. For example, status.yourcompany.com. Setup is a single CNAME record and takes about 3 minutes.

Why bring your own domain

Customers trust a domain they recognize. status.yourcompany.com signals that the status page is run by you, not a third party. It also:

• Keeps your branding consistent across all customer touchpoints
• Makes the URL easier to remember and share
• Lets you redirect from your main site without going through a third-party domain
• Works better with email filters that look at sender domain alignment

What you need

• A domain you control (yourcompany.com or any subdomain of it)
• Access to your DNS provider (Cloudflare, Route 53, Namecheap, GoDaddy, etc.)
• A LiveStatus account on the Starter plan or higher

Add your domain to LiveStatus

1. Go to your dashboard and open the status page you want to configure
2. Click Settings
3. Scroll to the "Custom domain" section
4. Enter the full domain you want to use (for example status.acme.com)
5. Click Save

LiveStatus will show you the CNAME target to point your domain at. It looks like this:

CNAME target: cname.livestatus.dev

Keep this tab open. You need the target value for the next step.

Add the DNS record

The instructions depend on your DNS provider. The basics are the same everywhere: create a CNAME record that points the subdomain you chose at the target LiveStatus gave you.

Cloudflare

1. Log in to Cloudflare and pick the zone for your apex domain
2. Click DNS in the sidebar
3. Click Add record
4. Type: CNAME
5. Name: the subdomain part only (for status.acme.com type status)
6. Target: cname.livestatus.dev
7. Proxy status: DNS only (gray cloud, not orange)
8. TTL: Auto
9. Save

Important: Cloudflare proxy must be off (gray cloud). If you turn it on, Cloudflare intercepts SSL and LiveStatus's automatic certificate provisioning will fail. You can turn it on later after the cert is issued, but test without it first.

Route 53 (AWS)

1. Open Route 53, pick the hosted zone for your apex domain
2. Click Create record
3. Record name: status (or whatever subdomain you picked)
4. Record type: CNAME
5. Value: cname.livestatus.dev
6. TTL: 300
7. Create record

Namecheap

1. Go to Domain List, click Manage next to your domain
2. Click Advanced DNS
3. Under Host Records, click Add New Record
4. Type: CNAME Record
5. Host: status (subdomain only)
6. Value: cname.livestatus.dev. (with a trailing dot)
7. TTL: Automatic
8. Save

GoDaddy

1. Go to DNS Management for your domain
2. Click Add under Records
3. Type: CNAME
4. Name: status
5. Value: cname.livestatus.dev
6. TTL: 1 hour
7. Save

Verification

LiveStatus checks for the DNS record every 10 minutes. You can also click the "Verify now" button in your settings to check immediately. Once the record is visible to us, we:

1. Mark the domain as verified
2. Request a Let's Encrypt certificate automatically
3. Issue and install the cert (takes about 30 seconds)
4. Start serving your page at the custom domain

Total time: usually 3 to 10 minutes from when you add the DNS record.

Apex domains

You can point a bare apex domain (acme.com with no subdomain) at LiveStatus, but apex CNAMEs are not standard DNS. A few providers support it with flattening:

• Cloudflare does CNAME flattening automatically, treating the CNAME as if it were the resolved A records. Works out of the box.
• Route 53 supports ALIAS records which behave like flattened CNAMEs. Use an ALIAS record pointing to cname.livestatus.dev.
• Most other providers do not support apex CNAMEs. In that case you need to either use a subdomain like status.acme.com instead, or move the zone to Cloudflare.

We strongly recommend using a subdomain like status.yourcompany.com rather than the apex, because it keeps your main domain free for your real site.

Troubleshooting

"Domain not verified" after 20+ minutes

• Check that the CNAME record actually exists by running dig CNAME status.yourcompany.com +short in a terminal. It should return cname.livestatus.dev.
• If the result is empty, the record hasn't propagated yet. Wait 10 more minutes
• If the result is something else (like your own server's IP), you have a conflicting A record. Remove it first
• If it returns Cloudflare IPs (104.21.x.x or 172.67.x.x), your Cloudflare proxy is on. Turn it off (gray cloud)

"SSL certificate issuance failed"

• Let's Encrypt can't issue a cert if the domain isn't resolving correctly. Fix the DNS issue first
• If your DNS is correct but the cert still fails, check that your DNS provider isn't using DNSSEC in a way that breaks CAA records. We need letsencrypt.org to be an allowed CA
• Contact support@livestatus.dev if you're stuck. We can manually trigger a cert re-issue

"It works on mobile but not desktop" (or vice versa)

This is a DNS cache issue on your end, not a LiveStatus problem. Clear your browser cache or try a different network. The global DNS propagation only takes about 5 minutes but your local DNS resolver may have cached the old record.

I want to move the domain to a different LiveStatus page

1. Remove the custom domain from the current page in Settings
2. Add it to the new page
3. You don't need to change the DNS record, it still points at the same target

I want to stop using the custom domain

1. Remove the custom domain from Settings
2. Delete the CNAME record from your DNS provider
3. Your page continues to work at livestatus.dev/your-slug

Security notes

• LiveStatus issues certificates for your domain automatically through Let's Encrypt. We do not see your private keys.
• Traffic between the user and LiveStatus is always HTTPS. HTTP redirects to HTTPS.
• If you need a higher-assurance certificate (EV), contact us. Business plan can use custom certificates.

Cost

Custom domain is included on Starter and above. There is no per-domain fee. You can have multiple status pages each with its own custom domain at no additional cost.

If you are on the free tier, you will need to upgrade to Starter ($19/mo) to use this feature.