Hosting Spaces on a custom domain
Archbee's Spaces can be made 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 Azure and CloudFlare 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 for the desired subdomain, 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.
Sign in to your domain's account at your domain host.
Locate the page for updating your domain's DNS settings. The page might be called something like DNS Management, Name Server Management, or Advanced Settings.
Create or change the CNAME for the subdomain you have chosen and configured in Archbee (might have been something like docs.yourcompany.com)
Set the value for it to proxy.archbee.com
Save your changes and wait until they take effect. An SSL certificate will be generated for your subdomain and deployed to our edge infrastructure to all your users.
While you're here, please check that your CAA record does not prevent Google Trust LLC (pki.goog) 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 technical people 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