Custom Domain

Serve a status page from your own subdomain, like status.yourcompany.com, instead of its exit1 address. Visitors stay on your brand, and the HTTPS certificate is issued and renewed for you.

Pro feature. Custom domains are included on the Pro plan. See Plans & Pricing.

Limits

Root domains are not supported. A root domain such as acme.com cannot point a CNAME record at another host, so use a subdomain such as status.acme.com.

The status page keeps working on its exit1 address too. A custom domain adds an address, it does not replace the old one.

Connect a Domain

1. Open Status Pages in the app and edit an existing status page. The page must be public and saved.
2. Open the Custom domain section.
3. Enter the hostname, for example status.acme.com, and click Connect.
4. The editor shows two DNS records. Add both at your DNS provider (see below).
5. Wait for the status to turn Active. The editor checks every 15 seconds while it is open. Click Check now after you change DNS.

Once the domain is active, the status page card shows the hostname, and the open link uses your domain.

DNS Records

Add these two records at your DNS provider. The editor shows the exact values with copy buttons.

The token is unique to your domain. Copy it from the editor.

Why the TXT record? It proves that you control the domain’s DNS before we serve anything on it. Without it, a CNAME left behind by someone else could let a stranger attach a page to your hostname.

Some DNS providers add the domain for you. If your provider’s form asks only for the host part, enter _exit1-verify.status for the TXT record and status for the CNAME. If you enter the full name and the provider appends the domain again, the record ends up at status.acme.com.acme.com and is never found.

After the domain is active, you may remove the TXT record. Keep the CNAME for as long as you use the domain. If you reconnect a domain that has been disabled or failed for more than 30 days, you need the TXT record again.

Switching From Another Status Page Provider

Add the TXT record first and leave your existing CNAME where it is. Once ownership is verified, switch the CNAME to domains.exit1.dev. The certificate is issued within minutes, so the switch has almost no downtime.

HTTPS

Certificates are issued and renewed automatically. There is nothing to upload and nothing to renew.

Cloudflare Users

If your domain’s DNS is on Cloudflare, you can keep the CNAME proxied (orange cloud). It also works with DNS only (grey cloud).

CAA Records

If your domain has CAA records, they must allow the certificate authorities used to issue your certificate. Add these if they are missing:

acme.com.  CAA  0 issue "letsencrypt.org"
acme.com.  CAA  0 issue "pki.goog"

If your domain has no CAA records at all, any authority may issue and you don’t need to add anything.

Statuses

Troubleshooting

Pending: “TXT record not found yet”

• Check that the record name is _exit1-verify. followed by your full hostname, and that the provider did not append the domain twice (see DNS Records).
• Check that the value is exactly exit1-verify=<token>, with no quotes or spaces added.
• DNS changes can take a few minutes, sometimes longer if the old record had a long TTL. Click Check now to check again.
• If the TXT record is not found within 72 hours, the domain moves to Failed.

Pending: “TXT record … does not match”

A TXT record exists at the right name but holds a different value, often from an earlier attempt. Replace it with the value shown in the editor.

Verifying for more than a few minutes

• Check that the CNAME for your hostname points at domains.exit1.dev. The certificate cannot be issued without it.
• If your domain has CAA records, check that they allow letsencrypt.org and pki.goog.
• If the domain does not become active within 72 hours, it moves to Failed.

Failed

The editor shows the reason. The usual causes:

• The TXT record was not found within 72 hours. Add the record and click Retry.
• The domain did not become active within 72 hours. Fix the CNAME or CAA records and click Retry.
• The CNAME no longer points at domains.exit1.dev. If the CNAME is changed or removed for more than 7 days, the domain is disconnected and the account owner gets an email. Point it back and click Retry.

Retry keeps the same TXT value, so you don’t need to change the TXT record.

Disabled

The account is no longer on Pro. See Downgrading From Pro.

”This hostname is connected to another status page”

Each hostname can be connected to one status page at a time. Remove it from the other page first. If it is on a page in an account you don’t control, contact connect@exit1.dev.

”Use a subdomain such as status.acme.com”

You entered a root domain. Use a subdomain instead.

”Pro includes 10 custom domains”

The account already has 10 domains. Remove one from another status page to add one here.

”Too many domain changes today”

Connecting and removing domains is limited per account per day. Try again tomorrow.

Remove a Domain

1. Open the status page in the editor.
2. In the Custom domain section, click Remove domain and confirm.
3. At your DNS provider, delete the CNAME and the TXT record.

The status page stops loading on your domain right away and stays available on its exit1 address. Delete the DNS records afterwards. A CNAME that points at us after the domain is removed does nothing useful, and stale records are best cleaned up.

Deleting a status page removes its custom domain first.

Downgrading From Pro

When an account leaves Pro, its custom domains are disabled:

• Visitors to your domain see a notice that the page is not available on this address, with a link to its exit1 address.
• The status page itself keeps working on its exit1 address, as long as it fits the new plan’s status page limit.
• For 14 days, reconnecting is instant: upgrade to Pro again and click Reconnect in the editor.
• After 14 days, reconnecting goes through Issuing certificate again, which takes seconds to minutes. After 30 days, the TXT record is checked again too.

Team members with editor access can manage custom domains. The account owner’s plan decides whether the feature is available.

Related

• Creating a Status Page
• Branding
• Plans & Pricing