Installing ThingsBoard PE from Azure Marketplace

This guide walks you through installing ThingsBoard Professional Edition from Azure Marketplace using the BYOL (Bring Your Own License) model. You get the license directly from ThingsBoard, Inc, and purchase the server instances and infrastructure from Azure.

• Active Microsoft Azure account

Open the ThingsBoard Professional Edition BYOL product page on Azure Marketplace.

Click "GET IT NOW". Review terms of use and click "Continue". Click "Create" to deploy your instance.

You will be redirected to the “Create a virtual machine” dialog.

• Create a new Resource group (e.g. thingsboard)
• Set a recognizable Virtual machine name (e.g. ThingsBoardPE-PROD)
• Choose a Region from the available list
• Set Administrator Account to SSH public key. Username must be ubuntu. See Azure SSH docs for key generation

Leave defaults or optionally add new disks.

Leave all settings as-is. The VM uses a preconfigured network security group.

Review the final product details and click Create to start the deployment.

Review settings and click "Create". Deployment may take up to 30 minutes (usually less than 5). Click "Go to resource" when deployment is complete.

Copy the external IP address of your instance from the resource overview page. You will need it in subsequent steps.

Register on the ThingsBoard License Portal to get your license. See How to get a pay-as-you-go subscription or How to get a perpetual license for details.

Save your license secret — you will need it in the next step.

Connect to your instance over SSH using the official Azure guide. Use the instance public IP from Step 3 and the SSH key from Step 2.1.

Open the configuration file:

sudo nano /etc/thingsboard/conf/thingsboard.conf

Locate the license configuration block and uncomment the export statement. Replace YOUR_LICENSE_SECRET_HERE with your actual license secret:

# License secret obtained from ThingsBoard License Portal (https://license.thingsboard.io)
# UNCOMMENT NEXT LINE AND PUT YOUR LICENSE SECRET:
export TB_LICENSE_SECRET=YOUR_LICENSE_SECRET_HERE

sudo service thingsboard start

Open the ThingsBoard web interface in your browser using your instance’s external IP address.

Default credentials:

• Login: [email protected]
• Password: sysadmin

1. Assign a valid DNS record to your instance’s external IP address.

2. Connect to your instance via SSH.

3. Run the following commands, replacing the domain and email with your own:

   sudo certbot-certonly --domain smth.yourcompany.com --email [email protected]
   sudo haproxy-refresh