Put your documentation on your own brand — `docs.yourcompany.com` — by connecting a custom domain. Doxbrix generates the DNS records you need, verifies ownership...
Put your documentation on your own brand — `docs.yourcompany.com` — by connecting a custom domain. Doxbrix generates the DNS records you need, verifies ownership...
Put your documentation on your own brand — docs.yourcompany.com — by connecting a custom domain. Doxbrix generates the DNS records you need, verifies ownership, and activates SSL automatically.
Connect a domain in Settings → Project → Custom Domains (/settings/project).
How it works
The section walks you through one flow: connect your domain, copy the generated DNS records, then verify and activate SSL. A domain moves through these stages, shown live as you go:
| Stage | Meaning |
|---|---|
| **Domain added** | You've entered the domain you want to use. |
| **DNS records ready** | Doxbrix has generated the exact records for you to add at your DNS provider. |
| **TXT detected** | The verification (TXT) record has been found — ownership is confirmed. |
| **Routing detected** | The routing record points traffic to your docs. |
| **Active** | The domain is live and serving over HTTPS. |
Connecting a custom domain
In Custom Domains, enter the domain you want to use — e.g. docs.yourcompany.com. A subdomain (like docs.) is recommended over a root/apex domain.
Doxbrix shows the exact records to create — a TXT record to verify ownership and a routing record to point traffic to your site. Add them at your DNS provider (Cloudflare, Route 53, Namecheap, etc.).
Doxbrix checks for the records. As each is found, the status advances through TXT detected and Routing detected.
Once verification completes, SSL is provisioned automatically and the domain becomes Active. All traffic is served over HTTPS.
docs. whenever possible — subdomains verify quickly and don't interfere with your main website's DNS.While DNS propagates
DNS changes can take from a few minutes to a few hours to propagate. The domain stays in its current stage until each record is detected, and Doxbrix keeps re-checking — you don't need to do anything but wait once the records are in place. You can confirm a record exists with an online DNS checker if a stage seems stuck.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Stuck before **TXT detected** | TXT record missing or not propagated | Re-check the record matches exactly; wait and retry |
| Stuck before **Routing detected** | Routing record missing or wrong target | Confirm the routing record matches what's shown |
| Certificate/HTTPS warning | SSL not yet activated | Wait a few minutes after the domain reaches **Active** |