Thingsboard Documentation

Documentation for using Thingsboard IoT Platform.

Installing Thingsboard on AWS EC2


IoT PaaS Demo


We recommend to use Thingsboard Live Demo for the seamless experience and the newest features from the latest source code!

Save time on the installation and configuration with several pre-provisioned devices, dashboards available in the cloud and pre-integrated email server to create new customer accounts and users.

This guide describes how to install Thingsboard on AWS EC2 using public AWS AMIs.

Step 1. Choose AMI

Use one of the following links to start the installation:

NOTE This AMIs are optimized for low memory instances, thus we do not recommend to use them for performance tests.

Step 2. Choose Instance Type

You can choose any instance type except t1.micro and t2.nano, since Thingsboard server and related third-party requires 1Gb of RAM. This instruction is verified on t2.micro which is eligible for free tier.

Step 3. Configure Instance

No specific configuration items here. You can leave this tab without changes or apply configuration that is specific to your use-case.

Step 4. Add Storage

Minimum 8 Gb of Storage is required. We recommend to have at least 50 if you plan to upload some data.

Step 5. Add Tags

No specific configuration items here. You can leave this tab without changes or apply configuration that is specific to your use-case.

Step 6: Configure Security Group

We recommend to create new security group, for example “Thingsboard”. Configure following inbound rules:

Type Protocol Port Range Source
HTTP TCP 80 0.0.0.0/0
SSH TCP 22 0.0.0.0/0
Custom TCP Rule TCP 1883 0.0.0.0/0
Custom UDP Rule UDP 5683 0.0.0.0/0
Step 7: Review and launch your instance

Once instance is launched, please wait some time for services to boot up and open Administration UI in the browser using public DNS from instance details.