Domains
Your own hostname, with a certificate that renews itself.
Domains
Section titled “Domains”Every project gets a Staleless subdomain when it is created. Connect your own hostname when you are ready.
Common choices: docs.example.com, help.example.com,
developers.example.com.
Connecting one
Section titled “Connecting one”-
Add the hostname
Enter it on the project’s domain screen. Staleless shows the DNS record you need.
-
Create the CNAME
One record, at your DNS provider, pointing your hostname at the Staleless target.
-
Wait for the certificate
Staleless requests it and re-reads the state. Two certificates are issued per hostname and both are renewed automatically.
-
Check it is live
The screen shows Active only when both the hostname and its certificate are active. Anything else is still pending.
The states
Section titled “The states”| State | Meaning |
|---|---|
| Unconfigured | No hostname entered. |
| DNS pending | The CNAME does not resolve to the target yet. |
| Verified | DNS is correct. The certificate is next. |
| Certificate provisioning | Issuance is in progress. |
| Active | Live. Both the hostname and the certificate are active. |
| Error | Something needs your attention. The screen says what. |
Warning
Do not announce the URL while the state is Certificate provisioning. A hostname that resolves without a valid certificate shows readers a browser warning.
Certificates
Section titled “Certificates”Issued and renewed automatically. You do not upload anything and you do not renew anything.
An expiring certificate on a customer’s domain is a support incident, so renewal is not left to a schedule somebody has to watch.
One domain, one project
Section titled “One domain, one project”A hostname maps to exactly one project. Pointing two projects at one hostname is refused rather than resolved to whichever answered first.
What happens to the subdomain
Section titled “What happens to the subdomain”Your Staleless subdomain keeps working after you connect a domain. Canonical tags and the sitemap point at the domain you chose, so search engines index the hostname you want and not the one we gave you.
Removing a domain
Section titled “Removing a domain”Detach it on the same screen. Readers fall back to the Staleless subdomain.
Deleting a project detaches its domain first. A hostname is never left pointing at nothing.