Domains

The Domains feature lets you configure a custom domain name for accessing ThingsBoard. Once a domain is registered, users can open the ThingsBoard web interface using that domain instead of the default address.

Add domain

Log in to ThingsBoard as a system administrator. Navigate to Security → OAuth 2.0 and open the Domains tab. Click the + icon.
Enter a valid domain name in the Domain name field and click Add.

3. Your domain name appears in the Domains tab.

Set up a CNAME record

To point your domain to ThingsBoard, add a CNAME record at your DNS provider:

Field	Value
Type	`CNAME`
Name / Host	Your subdomain (e.g. `mycompany`)
Target / Value	See note below
TTL	`3600` (or your provider’s default)

Instructions for common DNS providers:

Access ThingsBoard via your domain

Once the domain is registered, you can use it in your browser to access the ThingsBoard web interface and services.

Domain details

Click on a registered domain to open the details dialog. It displays:

The CNAME record for the domain.
The SSL certificate details, including the validity period (Not before and Not after dates).

Delete a domain

To remove a registered domain, click the trash icon in its row and confirm the deletion. After deletion, the domain is no longer available and its SSL certificate is removed.

Troubleshooting

If your domain is not resolving correctly, verify your CNAME record using Google Admin Toolbox or the dig command on Linux:

dig $YOUR_DOMAIN_NAME any

Example:

dig mycompany.thingsboard.space any

A correctly configured CNAME record produces output similar to:

;; ANSWER SECTION:
mycompany.thingsboard.space. 3600 IN    CNAME   eu.thingsboard.cloud

If the answer section is missing or shows an HINFO record instead of CNAME, the DNS record is not configured correctly. Check your DNS provider settings and wait for propagation (up to 24–48 hours for some providers).