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


This guide will help you to get familiar with Thingsboard configuration files and parameters.

Once you have installed Thingsboard, you can find configuration files in the following directory:


We will describe main configuration files below.


Main configuration file that contains properties for transports (HTTP, MQTT, CoAP), database(Cassandra), clustering (Zookeeper and gRPC), etc. The configuration file is written in YAML.

All configuration parameters have corresponding environment variable name and default value. In order to change configuration parameter you can simply change it’s default value. For example:

  address: "${HTTP_BIND_ADDRESS:}"

In this case, ‘HTTP_BIND_ADDRESS’ is environment variable name and ‘’ is a default value. Environment variables are useful in case of docker installation. See docker documentation for more details.

We will not explain all configuration parameters here. You can review their description in the configuration file itself.


Configuration file for startup script. Contains Java options and classpath related parameters.


Actor system configuration. Contains general actor system properties and configuration of Akka dispatchers. Allows performance tuning for specific use cases.


Configuration file for logging. Allows to control log level, size of log files and total size/volume of logs.