ThingsBoard Documentation

Documentation for using ThingsBoard IoT Platform.

Installing ThingsBoard IoT Gateway on Linux

Step 1. Install Java 8

IoT Gateway requires Java 8. Although you are able to start the service using OpenJDK, the solution is actively tested on Oracle JDK.

Follow this instructions to install Oracle JDK 8:

Please don’t forget to configure your operating system to use Oracle JDK 8 by default. Corresponding instructions are in the same articles listed above.

Step 2. Download installation package

Download installation package or build it from source.


Step 3. Install gateway as a service

sudo dpkg -i tb-gateway-1.4.0.deb
sudo rpm -Uvh tb-gateway-1.4.0.rpm

Congratulations! ThingsBoard IoT Gateway is now installed on your Linux machine 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.