Thingsboard Documentation

Documentation for using Thingsboard IoT Platform.

Installing Thingsboard on Raspberry Pi 3 Model B

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 a Raspberry Pi 3 running Raspbian Jessie.

Third-party components installation


Thingsboard service is running on Java 8. Oracle Java 8 is already pre-installed on Raspbian. You can check java version using following command

$ java -version
java version "1.8.0_65"
Java(TM) SE Runtime Environment (build 1.8.0_65-b17)
Java HotSpot(TM) Client VM (build 25.65-b01, mixed mode)

Any Java version higher then or equal to 1.8 is fine.


Thingsboard service requires Cassandra database. Instructions listed below will help you to install Cassandra.

Download and install cassandra using following commands

$ wget
$ sudo dpkg -i cassandra_3.9_all.deb

By default, Cassandra will consume almost all RAM on the board and will be quite slow. In order to fix this run following commands:

# Stop cassandra service
$ sudo service cassandra stop

# Find and set memory options in /etc/cassandra/

# Find and set timeout options in /etc/cassandra/cassandra.yaml
read_request_timeout_in_ms: 20000
range_request_timeout_in_ms: 20000
write_request_timeout_in_ms: 20000
counter_write_request_timeout_in_ms: 50000
cas_contention_timeout_in_ms: 10000
truncate_request_timeout_in_ms: 120000
request_timeout_in_ms: 60000

# Start cassandra service
$ sudo service cassandra start

Thingsboard service installation

Download installation package or build it from source.

# Download the package
$ wget
# Install Thingsboard as a service
$ sudo dpkg -i thingsboard-1.2.3.deb
# Update Thingsboard memory usage and restrict it to 150MB in /etc/thingsboard/conf/thingsboard.conf
export JAVA_OPTS="$JAVA_OPTS -Dplatform=rpi -Xms150M -Xmx150M"
Provision database schema and initial data

Once Cassandra and Thingsboard services are installed, you can execute following scripts:

# Open cassandra shell and create thingsboard keyspace
# This may cause timeout due to it's a heavy operation. 
# In case of timeout just wait a minute or two.
$ cqlsh
cqlsh> CREATE KEYSPACE IF NOT EXISTS thingsboard WITH replication = {'class' : 'SimpleStrategy', 'replication_factor' : 1};

# This may cause timeout. In case of timeout just repeat the command.
$ cqlsh -f /usr/share/thingsboard/data/schema.cql
$ cqlsh -f /usr/share/thingsboard/data/system-data.cql
$ cqlsh -f /usr/share/thingsboard/data/demo-data.cql
Start Thingsboard service

Execute following command to start Thingsboard:

# Start the service
$ sudo service thingsboard start
# Monitor startup status
$ tail -f /var/log/thingsboard/thingsboard.log | grep Started
2016-12-13 13:44:52,407 [main] INFO  o.t.s.ThingsboardServerApplication - Started ThingsboardServerApplication in 113.64 seconds (JVM running for 118.624)

Once started, you will be able to open Web UI using following link:


NOTE: Please allow up to 2 minutes for the Web UI to start


Thingsboard logs are stored in the following directory:


You can issue the following command in order to check if there are any errors on the backend side:

cat /var/log/thingsboard/thingsboard.log | grep ERROR