ThingsBoard Documentation

Documentation for using ThingsBoard IoT Platform.

Installing ThingsBoard IoT Gateway on Raspberry Pi 3 Model B

This guide describes how to install ThingsBoard IoT Gateway on a Raspberry Pi 3 running Raspbian Jessie.

Step 1. Install Java 8

IoT Gateway service is running on Java 8. Oracle Java 8 is already pre-installed on Raspbian. You can check java version using the 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 than or equal to 1.8 is fine.

Step 2. Download installation package

Download installation package or build it from source.

# Download the package
$ wget

Step 3. Install gateway as a service

# Install gateway as a service
$ sudo dpkg -i tb-gateway-1.4.0.deb
# Update gateway memory usage and restrict it to 150MB in /etc/tb-gateway/conf/tb-gateway.conf
export JAVA_OPTS="$JAVA_OPTS -Dplatform=rpi -Xms150M -Xmx150M"

Congratulations! ThingsBoard IoT Gateway is now installed on your Raspberry as a service.

Step 4. Configure your gateway

Let’s configure your gateway before we start it!

Let’s skip extension configuration for now. We need to validate that gateway is able to successfully connect to ThingsBoard server first.

Navigate to the configuration folder /etc/tb-gateway/conf and configure connection to ThingsBoard server. See getting started or general configuration for more details.

Step 5. Launch your gateway

Now let’s start the gateway! Execute the following command to start gateway:

sudo service tb-gateway start

In order to restart the gateway you can execute following commands

sudo service tb-gateway restart

Step 6. Troubleshooting your installation

The log files are located in /var/log/tb-gateway folder.

The tb-gateway.log file should contain following line:

YYYY-MM-DD HH:mm:ss,sss [main] INFO  o.t.gateway.GatewayApplication - Started GatewayApplication in seconds (JVM running for

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

cat /var/log/tb-gateway/tb-gateway.log | grep ERROR

In case of any unclear errors, use general troubleshooting guide or contact us.

Next Steps

Use OPC-UA, MQTT, Sigfox Backend or Modbus slave extensions to integrate your devices with ThingsBoard platform.