Custom domains

Any library can be served on a domain of your own, such as docs.example.com, instead of your team's address. Owners and admins manage domains on the Custom domains screen: in a library's Settings, under Custom domain, choose Manage custom domains (or open https://app.docsahoy.com/team/domains).

Add and verify a domain

1. Add the domain, without https:// or a path: docs.example.com.
2. At the company that runs your domain's DNS, add the TXT record the screen shows. Its name starts with _docsahoy-challenge.; its value is a code made for your team. It proves the domain is yours.
3. Press Check again. We ask your domain's own nameservers, so a record you just added is usually found straight away; some DNS hosts take a while to publish it.

Point it at Docs Ahoy

Readers can only reach the domain once it points at us:

• a subdomain such as docs.example.com gets a CNAME record with the value custom.docsahoy.eu;
• a bare domain such as example.com can't have a CNAME: it gets the A and AAAA addresses the screen shows.

_docsahoy-challenge.docs.example.com   TXT     "the code from the screen"
docs.example.com                       CNAME   custom.docsahoy.eu

Choose its libraries

In a library's Settings, under Custom domain, choose the verified domain. Each domain can have its own home library: the library its bare address opens.

The certificate

Once a published library is on the domain and it points at us, a certificate is issued automatically, usually within seconds. You don't upload or renew anything.

Only when the domain is verified, points at us and opens securely do we send readers there. Until then, the library stays at your team's address. After that, the team address forwards to the domain, so old links keep working.

Removing a domain

Removing a domain serves its libraries on your team's address again.