Thingsboard Documentation

Documentation for using Thingsboard IoT Platform.

Installing Thingsboard using Docker (Linux or Mac OS)


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 will help you to install and start Thingsboard using Docker on Linux or Mac OS.

Installation steps

mkdir <docker-folder>
cd <docker-folder>
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.2/docker/docker-compose.yml > docker-compose.yml
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.2/docker/docker-compose.random.yml > docker-compose.random.yml
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.2/docker/.env > .env
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.2/docker/thingsboard.env > thingsboard.env
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.2/docker/thingsboard-db-schema.env > thingsboard-db-schema.env
sudo rm -rf /home/docker/cassandra_volume
sudo docker-compose -f docker-compose.yml -f docker-compose.random.yml up -d
http://localhost:8080/

Advanced usage

.env file

One can modify .env file to configure following parameters:

thingsboard.env file

One can set thingsbord service environment variables using this file. See configuration for more details.

thingsboard-db-schema.env file

One can modify thingsboard-db-schema.env file to configure following parameters:

Thirdparty components

One can start only Thingsboard thirdparty components. This may be useful for Thingsboard contributors in order to launch Thingsboard node from IDE. In order to do this, download docker-compose.static.yml file and replace last installation step with

sudo docker-compose -f docker-compose.yml -f docker-compose.static.yml up -d

Troubleshooting

DNS issues

Note If you observe errors related to DNS issues, for example

127.0.1.1:53: cannot unmarshal DNS message

You may configure your system to use Google public DNS servers. See corresponding Linux and Mac OS instructions.