Custom Domains

Last updated by sai 2 years ago

If you are on the Pro or Business plan, you can map your space to a custom domain. This means instead of your Space being hosted at yourcompany.kbee.app , you can have it hosted at help.yourcompany.com

Add Domain

In your Kbee dashboard, navigate into the space you want to set up a custom domain for. Click the “Settings'' button

Then scroll down to “Custom Domains”

Click “+ Add Custom Domain ”

Enter in the new Domain and click “Add Domain”

Set up DNS

You will need to configure your DNS provider to map your domain to Kbee.

For the subdomain you selected, set a CNAME record with the value cname.kbee.app.

For example, if you are using Google Domains it would look like this:

Once the DNS propagation has completed, you will see a checkmark:

Note: This process can take up to 24 hours to complete!

Please contact us if you have any questions on this step.

SSL

Kbee will automatically provision a SSL certificate for you. Once the certificate is issued, your custom domain will be live!

Kbee will send you an email once the custom domain is live.

Note: This process can take up to 24 hours to complete!

Vercel Users

Currently, Vercel has a technical limitation: each domain (e.g, yourdomain.com ) can be associated with only one Vercel account. As Kbee uses Vercel to host your space, the following workaround is necessary for customers already using Vercel:

Download the Vercel CLI — You'll need this to create a new project. Then login from the command line with the vercel login command.

Create a new folder somewhere locally called "kbee-custom-domain"

In that folder, create a file called vercel.json with the following contents:

{
"rewrites":
[
{
"source": "/(.*)",
"destination": "https://yourspace.kbee.app/$1"
}
]
}

Replace “yourspace” with your Kbee subdomain

From within the "kbee-custom-domain" folder, run vercel deploy . It will guide you through creating a new project on Vercel and will deploy it.

Go into the Vercel UI, open the project you just created, and in Settings > Domains , add the desired subdomain for your Kbee space

(example: wiki.yourdomain.com ) .

Let us know if you have any trouble setting this up!