Stand with Ukraine flag
Try it now Pricing
IoT Gateway
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker
Installation > IoT Gateway installation on CentOS/RHEL (RPM)
Getting Started Documentation

Install ThingsBoard IoT Gateway as package.

This guide will help you to install ThingsBoard IoT Gateway on CentOS or RHEL.


  • Install Python version 3.7 or higher.

Step 1. Download the installation package

Download installation package.


Step 2. Install the gateway using yum

Install ThingsBoard IoT Gateway as package and run it as daemon use the following command:

sudo yum install -y ./python3-thingsboard-gateway.rpm

Step 3. Check gateway status

systemctl status thingsboard-gateway

You may notice some errors in the output. However, it is expected, since gateway is not configured to connect to ThingsBoard yet:

... python3[7563]: ''2019-12-26 09:31:15' - ERROR - mqtt_connector - 181 - Default Broker connection FAIL with error 5 not authorised!'
... python3[7563]: ''2019-12-26 09:31:15' - DEBUG - mqtt_connector - 186 - "Default Broker" was disconnected.'
... python3[7563]: ''2019-12-26 09:31:16' - DEBUG - tb_client - 78 - connecting to ThingsBoard'
... python3[7563]: ''2019-12-26 09:31:17' - DEBUG - tb_client - 78 - connecting to ThingsBoard'

Step 4. Configure the gateway

Now you can go to configuration guide to configure the gateway. In order for the changes to be saved, we need to restart the gateway.

systemctl restart thingsboard-gateway