ThingsBoard Documentation

Documentation for using ThingsBoard IoT Platform.
ThingsBoard Professional Edition with White-labeling and Platform Integrations Learn More

Installing ThingsBoard PE from AWS Marketplace

This guide describes how to install ThingsBoard Professional Edition from AWS Marketplace.

With this option you pay for Thingsboard Professional Edition on hourly basis. Software usage for the first 5 days is free of charge.

Step 1. Subscribe to ThingsBoard Professional Edition


Step 2. Configure instance and Launch

In 1-Click Launch tab select required properties:


After configuration is finished press Launch with 1-click. New EC2 instance will be created and started with installed Thingsboard Professional Edition and Cassandra as data storage. You can go to your AWS EC2 console to view Instance details by clicking on the link highlighted on the image below:


Step 3. Check instance status

In AWS EC2 console you need to wait while instance state will be changes to running and all Status checks will be finished.


On the image above example instance has this Public DNS name

Instance ID

Step 4. Connect to Thingsboard UI

Now you can open this link in your browser:

In this example it is:

Use this login to connect as system Administrator

Default password for System Administrator is Instance ID (from Step 3). In this example it is

Now you can proceed with Thingsboard Configuration.

Optional: Connect to Thingsboard over SSH

You can use configured key pairs for accessing Thingsboard instance over SSH. Below is example command as a reference:

ssh -i awstbkey.pem

Thingsboard configuration file location:

Thingsboard logs location:

Optional: Create a new key pair for AWS EC2 region

If it is your first experience with AWS, you will need to generate SSH key pairs before starting any EC2 instances. Those keys are used for secured access via SSH to the instance.

Here are steps for creating your first key pair



Finally your private SSH key will be downloaded. Please save it in safe place in order to get access to your instance over SSH.