Skip to content
Stand with Ukraine flag

Installing ThingsBoard PE from GCP Marketplace

This guide walks you through installing ThingsBoard Professional Edition from GCP 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 GCP.

  • Active GCP account

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

Click Launch on Compute Engine. You can use the default settings or customize them. When ready, click Deploy.

Once the deployment completes:

Click SSH to open a browser-based SSH session. Keep this window open — you will use it in Step 3.

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.

Open the configuration file:

Terminal window
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:

Terminal window
# 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
Terminal window
sudo service thingsboard start

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

Default credentials:

  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:

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