Domains

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

1. Log in to ThingsBoard as a system administrator. Navigate to Security ⇾ OAuth 2.0 and open the Domains tab. Click the + icon.
2. Enter a valid domain name in the Domain name field and click Add.
3. A reminder appears to add a CNAME record to your domain’s DNS configuration. After adding the record, click I’ve added CNAME records. Domain verification and SSL certificate provisioning will begin.
4. Once verified, your domain name appears in the Domains tab.

Navigate to Security → OAuth 2.0 → Domains and click + to add a new domain. Enter the domain name and click Add. Add the CNAME record at your DNS provider, then click "I've added CNAME records" to start verification. After successful verification, the domain appears in the Domains tab.

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

Instructions for common DNS providers:

• Amazon Route 53
• GoDaddy
• Cloudflare
• ClouDNS
• Google Cloud DNS
• Name.com
• easyDNS
• DNSimple
• DNSMadeEasy
• No-IP.com
• Infoblox NIOS
• Namecheap

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

Click 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).

The domain details dialog showing the CNAME record and SSL certificate information. SSL certificate validity period shown in the domain details dialog.

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.

Click the trash icon in the domain row to start deletion. Confirm the deletion. The domain and its SSL certificate will be removed.

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).