Star

Guides

How to get started, and accomplish tasks, using Thingsboard.

Installing Thingsboard using Docker (Linux or Mac OS)

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.1/docker/docker-compose.yml > docker-compose.yml
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.1/docker/docker-compose.random.yml > docker-compose.random.yml
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.1/docker/.env > .env
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.1/docker/thingsboard.env > thingsboard.env
curl -L https://raw.githubusercontent.com/thingsboard/thingsboard/release-1.1/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.