By default, a Rocket.Chat cloud-hosted workspace uses a rocket.chat URL, such as: your-workspace.rocket.chat
You can configure a custom domain, such as chat.example.com, and use it to access your workspace.
You must own the domain and have permission to manage its DNS records.
Configure a custom domain
Sign in to your Rocket.Chat Cloud account.
Select Workspaces, then select the workspace you want to configure.
Next to the workspace’s current URL, select Edit to open the DNS Settings panel.
.png)
Under Use default URL, you can see the workspace’s current
rocket.chatURL..png)
Select Use custom domain.
In Set new domain, enter the domain you want to use to access the workspace, for example,
chat.example.com. Enter only the domain. Do not includehttps://or a path..png)
Under Create CNAME record, copy the displayed Rocket.Chat URL. You will use this value as the target of your CNAME record.
.png)
Sign in to the service that manages the DNS records for your domain. This may be your domain registrar or a separate DNS provider, such as Cloudflare.
Create a CNAME record using the following values:
Setting
Value
Type
CNAMEName or host
The subdomain you entered, such as
chatTarget or value
The Rocket.Chat URL copied from the DNS Settings panel
TTL
Use your DNS provider’s default value
Return to the DNS Settings panel in Rocket.Chat Cloud and select Save.
Your custom domain shows a pending status while Rocket.Chat verifies the DNS configuration. DNS changes can take up to 24 hours to propagate. After verification succeeds, Rocket.Chat Cloud sends you a confirmation email, and you can access the workspace through the custom domain.
Use the default Rocket.Chat URL
The Use default URL option displays the original workspace URL assigned by Rocket.Chat, such as your-workspace.rocket.chat.
To stop using the custom domain and return to this URL:
Open the workspace’s DNS Settings.
Select Use default URL.
Select Save.