HOSTED SPACES

Hosting Spaces on a custom domain

6min

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.

How to add a custom domain

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.

1

Select the Space you want to publish to a domain.

2

Click on the gear icon to open the Space settings.

3

Navigate to the Custom Domain tab.

4

Next, you have to follow the steps mentioned there.

Document image


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.

1

Sign in to your domain's account at your domain host.

2

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.

3

Create or change the CNAME for the subdomain you have chosen and configured in Archbee (might have been something like docs.yourcompany.com)

4

Set the value for it to proxy.archbee.com

5

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.

How to find your domain host

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.

2

In the search field, enter your domain name and click Lookup.

3

On the results page, scroll down to Registrar Information.

The registrar is usually your domain host.

How to add a CNAME

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.

Hello, Would you please help me add a CNAME record to my domain's DNS records? My domain is: e.g., archbee.io (replace it with your domain) My CNAME record (destination/target) is: e.g., demo.archbee.io (replace it with the subdomain where you want to Space to be hosted) My CNAME record (host/label) points to: proxy.archbee.com (don't change this one) Please get in touch with me at: {your email address} Thanks, {your name}

How to add a CNAME with popular providers

🤔
Have a question?
Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.