Star

Installation

Documentation for installation and configuration of ThingsBoard IoT Platform.

Installing ThingsBoard PE from GCP Marketplace

This guide describes how to install ThingsBoard Professional Edition from GCP Marketplace. Using this guide you will install bring-your-own-license (BYOL) version of the product. Basically, you get the license directly from ThingsBoard, Inc, but purchase corresponding server instances and infrastructure from GCP.

Prerequisites

Step 1. Launch ThingsBoard PE BYOL

Open ThingsBoard Professional Edition BYOL product page on GCP Marketplace.

image

image

That’s it! Your ThingsBoard instance is now deploying! When complete you should see:

image

Step 2. Obtain your license secret

In order to activate your ThingsBoard instance you will need to get the license secret. ThingsBoard Licenses are managed by ThingsBoard License Portal.

Please register on ThingsBoard License Portal to get your license. See How-to get pay-as-you-go subscription or How-to get perpetual license for more details.

Please save your license secret to a safe place. We will use them later in this guide.

Step 3. Configure your license secret

Once you get the license secret, you should put it to the thingsboard configuration file.

Step 3.1. Put License Secret to thingsboard configuration file

Open the file for editing using the following command:

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

Locate the following configuration block:

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

and put your license secret. Please don’t forget to uncomment the export statement. See example below:

# 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

Step 4. Launch ThingsBoard service

Execute the following command to start ThingsBoard:

sudo service thingsboard start

Please allow up to 120 seconds for the Web UI to start. This is applicable only for slow machines with 1-2 CPUs or 1-2 GB RAM.

Step 5. Connect to Thingsboard UI

Now you can open this link in your browser:

image

Use this login to connect as system Administrator

Default password for System Administrator is sysadmin

Now you can proceed to the next steps.

Post-installation steps

Configure HAProxy to enable HTTPS