---
title: Hosting Spaces on a custom domain
slug: archbee-docs/hosting-spaces-on-a-custom-domain
description: Learn how to host Archbee Public Spaces on your own domain with auto-renewable SSL certificates and guaranteed uptime. Our document provides simple steps for setting up your custom domain, adding a CNAME record, and modifying DNS settings. Unsure about ad
docTags: 
createdAt: 2019-09-17T12:04:43.000Z
---

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.

::::WorkflowBlock
:::WorkflowBlockItem
Select the Space you want to publish to a domain.
:::

:::WorkflowBlockItem
Click on the gear icon to open the Space settings.
:::

:::WorkflowBlockItem
Navigate to the Custom Domain tab.
:::

:::WorkflowBlockItem
Next, you have to follow the steps mentioned there.
:::
::::

![](https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/9jz4rdlg0QJTgJ9o799Q-_hosted-light.png)

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.

::::WorkflowBlock
:::WorkflowBlockItem
Sign in to your domain's account at your domain host.
:::

:::WorkflowBlockItem
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.
:::

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

:::WorkflowBlockItem
Set the value for it to `proxy.archbee.com`
:::

:::WorkflowBlockItem
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.
:::
::::

:::hint{type="warning"}
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.

:::hint{type="info"}
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.

::::WorkflowBlock
:::WorkflowBlockItem
Go to [lookup.icann.org](https://lookup.icann.org/).
:::

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

:::WorkflowBlockItem
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.

:::BlockQuote
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**

\[[https://docs.gandi.net/en/domain\_names/common\_operations/link\_domain\_to\_website.html](https://docs.gandi.net/en/domain_names/common_operations/link_domain_to_website.html)]\([https://docs.gandi.net/en/domain\_names/common\_operations/link\_domain\_to\_website.html](https://docs.gandi.net/en/domain_names/common_operations/link_domain_to_website.html))
