Hosting Spaces on a custom domain
This feature is available on these plans: ✔️ Growing ✔️ Scaling ✔️ Enterprise
Archbee's Spaces can be Public and hosted on your domain with auto-renewable SSL certificates and guaranteed uptime as part of our SLA. We host your content on your domain through AWS's CloudFront CDN to be fast and reliable.
To publish your documentation portal to a custom domain (e.g., docs.yourdomain.com), you first need to set it up.
You need to set up your domain to enable the publish mode and get the preview and production environments. Adding a custom domain isn't as complex as it seems, and here's what you need to do.
- Select the Space you want to publish to a domain.
- Click on the gear icon to open the Space settings.
- Navigate to the Custom Domain tab.
- Next, you have to follow the steps mentioned there.
To add a CNAME, you need access to the domain registrant. This is typically where you purchased your domain name (like GoDaddy, Enom, or Name.com).
If you have access to add a CNAME, follow these steps, but also use the domain registrant knowledge base. We linked to some of the provider's documentation to help you out.
- Copy the CNAME record from Step 1.
- Sign in to your domain's account at your domain host.
- Locate the page for updating your domain's DNS records.
- The page might be called something like DNS Management, Name Server Management, or Advanced Settings.
- Add the CNAME record you copied from Step 1.
- Save your changes and wait until they take effect.
While you're here, please check that your CAA record does not prevent Lets Encrypt (main SSL provider) or ZeroSSL (our fallback SSL provider) to generate SSL certificates for your domain.
Lastly, check if the DNS has propagated. CNAME record changes can take up to 72 hours to go into effect, but typically they happen much sooner.
Next, you must set the Space public, add your subdomain in Step 4, then click Set.
When a new domain is configured, an automated publish will be triggered, and publish mode is activated, and now you can publish to production.
You can search for your domain host online if you can't find your billing records.
The Internet Corporation for Assigned Names and Numbers (ICANN) is a non-profit organization that collects domain information. Use the ICANN Lookup tool to find your domain host.
- Go to lookup.icann.org.
- In the search field, enter your domain name and click Lookup.
- On the results page, scroll down to Registrar Information.
The registrar is usually your domain host.
If you don't know how to add the CNAME, use this template to email your domain host for help adding your unique CNAME record to your DNS records.
Please enter your unique Label/Host and Destination/Target text into the email before sending it to your domain host's support team or somebody from your team.
How to add a CNAME with popular providers