diff --git a/communicate/status-pages/custom-domain.mdx b/communicate/status-pages/custom-domain.mdx index d8a15f21..b5186d4e 100644 --- a/communicate/status-pages/custom-domain.mdx +++ b/communicate/status-pages/custom-domain.mdx @@ -5,7 +5,7 @@ sidebarTitle: "Custom Domain" canonical: 'https://www.checklyhq.com/docs/communicate/status-pages/custom-domain/' --- -You can host your status page on your own domain. To set it up, add the domain in Checkly and create the required DNS records with your DNS provider. +You can host your status page on your own domain. To set it up, add the domain in Checkly and create the required DNS records with your DNS provider. Checkly then issues a TLS certificate for your domain and renews it automatically. Custom domains are available on Communicate Starter, Team and Enterprise @@ -15,6 +15,8 @@ You can host your status page on your own domain. To set it up, add the domain i ![Custom domain configuration](/images/docs/images/status-pages/status-pages-custom-domain-1.png) + +Save your status page. Checkly then lists the DNS records your domain needs below the custom domain field. @@ -26,14 +28,28 @@ You can host your status page on your own domain. To set it up, add the domain i should always be set to DNS only. - -After you've added your custom domain and saved the page, one or more TXT records will be displayed depending on the domain you're using. + +New domains are validated over HTTP, so the CNAME record is usually all you need. If Checkly shows TXT records for your domain, add them to your DNS configuration as well. ![Example custom domain TXT configuration](/images/docs/images/status-pages/status-pages-custom-domain-3.png) -Update your DNS settings to match the TXT record(s) displayed on your status page to prove the ownership of the domain. - - -Search engines require this verification to index and list your status page. - +Select **Refresh domain status** to check your setup. Once your DNS is set up, issuing the certificate usually takes a few minutes. A green check next to the custom domain field means your domain is verified. + +## Certificate renewal and troubleshooting + +Checkly renews the certificate for your custom domain automatically. Domains validated over HTTP need no DNS changes to renew, as long as the CNAME record keeps pointing to `custom-domain.checkly-status-page.com`. Don't remove or change that record while the status page uses your domain. If your domain was set up with TXT records and Checkly shows new TXT records, add them, then select **Refresh domain status**. + +If your domain has CAA records, they must allow the certificate authority `pki.goog`, which issues your status page certificate. + +If something goes wrong, the status page settings show one of these messages below the custom domain field: + +| Message | What to do | +|---------|------------| +| "Certificate validation failed: …" | The certificate couldn't be validated. Fix the reason given in the message, then select **Refresh domain status**. | +| "Cloudflare reported a certificate validation failure for this domain." | Select **Refresh domain status**. If the message stays, contact [support@checklyhq.com](mailto:support@checklyhq.com). | +| "Your domain's CAA records do not allow our certificate authority to issue a certificate." | Remove the CAA records on your domain, or add `0 issue "pki.goog; cansignhttpexchanges=yes"` alongside your existing policy. Then select **Refresh domain status**. | +| "Certificate issuance timed out for this domain." | Select **Refresh domain status** to start a new certificate order. | +| "Cloudflare has not returned the certificate validation records yet." | Wait a moment, then select **Refresh domain status** to check again. | + +If refreshing doesn't help, remove the custom domain from your status page, save, then add it again and save.