Custom Domains (Pro Plan)
This guide walks you through the steps of adding, updating, and removing a custom domain on your Hub. This feature is available on Professional plans.
Table of Contents
Introduction
Part A: Prepare Your Custom Domain
Part B: Locate Your turkeyauthtoken
Part C: Connect Your Custom Domain
Updating Your Custom Domain
Removing Your Custom Domain
Introduction
Custom domains allow Professional Plan subscribers to improve the branding, analytics collection, and search optimization of their Hub. Be advised that, once connected, old room and scene urls may be inaccessisble.
If you need more assistance, we recommend following along with our Custom Domain Tutorial Video.
Part A: Prepare Your Custom Domain
The custom domain preparation process will vary depending on the type of domain and hosting service you are using. We will update our documentation as we test the differences between services and domain types.
With a CNAME Record
The easiest method to connect a custom domain to your Hub is to create a cname record to point to lb.us1.myhubs.net
. Before connecting the custom domain, you must register a cname record through your desired custom domain’s registrar, such as GoDaddy or Route53 (AWS), to point to lb.us1.myhubs.net
. We have documented this process using Route53 in our tutorial video.
turkeyauthtoken
Part B: Locate Your Open the developer tools in the subscription dashboard and navigate to the “Console” tab.
Run the following code in the console to get your token:
console.log(RegExp("_turkeyauthtoken"+"=[^;]+").exec(document.cookie)[0].slice(17))
Copy the long string of characters to be used in Part C. Please note that turkeyauthtokens are only valid for 12 hours.
Part C: Connect Your Custom Domain
Open a command terminal on your device and run the following command with the 3 parameters surrounded by
< >
replaced with your specific information from previous steps:
curl -X PATCH -H "turkeyauthtoken:<token-value-from-part-b>" 'https://<your-hubs-native-domain>/api/ita/custom-domain?to_domain=<desired-custom-domain>'
The command should execute quickly and return the following message:
done: [<your-hubs-native-domain>] -> [<desired-custom-domain>]
It will generally take a couple of minutes for the custom domain to be properly configured on the backend.
Updating Your Custom Domain
In a command terminal on your device, run the following command with the 4 parameters surrounded by
< >
replaced with your specific information from previous steps:
curl -X PATCH -H "turkeyauthtoken:<token-value-from-part-b>" 'https://<your-hubs-native-domain>/api/ita/custom-domain?from_domain=<current-custom-domain>&to_domain=<desired-custom-domain>'
^ Note how we have added thefrom_domain
parameter to this command ^The command should execute quickly and return the following message:
done: [<current-custom-domain>] -> [<desired-custom-domain>]
It will generally take a couple of minutes for the custom domain to be properly configured on the backend.
Removing Your Custom Domain
In a command terminal on your device, run the following command with the 3 parameters surrounded by
< >
replaced with your specific information from previous steps:
curl -X PATCH -H "turkeyauthtoken:<token-value-from-part-b>" 'https://<your-hubs-native-domain>/api/ita/custom-domain?from_domain=<current-custom-domain>&to_domain='
^ Note how we have left theto_domain
parameter empty in this command ^The command should execute quickly and return the following message:
done: [<current-custom-domain>] -> []
It will generally take a couple of minutes for the custom domain to be properly configured on the backend.