Star

Installation

Documentation for installation and configuration of ThingsBoard IoT Platform.

Installing ThingsBoard on AWS EC2


IoT PaaS Demo


We recommend to use ThingsBoard Professional Edition 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 type, instance type and region

ThingsBoard supports two AMI types depending on the database used:

Both AMIs are based on monolithic version of ThingsBoard and are deployed as a docker container inside the Ubuntu 18.04 VM. Both AMIs are created to simplify the deployment and getting started process. We recommend to use those AMIs as a shared development environments and move to microservices deployment once you plan a production deployment.

Use one of the following links to start the installation for Cassandra based AMIs:

Use one of the following links to start the installation for PostgreSQL based AMIs:

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

Step 2. Configure Instance

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

Step 3. Add Storage

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

Step 4. Add Tags

No specific configuration items here. You can leave this tab without changes or apply a 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 the 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.