ThingsBoard IoT Gateway

Integrate legacy and third-party systems with ThingsBoard platform using IoT Gateway.

Install ThingsBoard IoT Gateway using Docker.

This guide will help you to install and start ThingsBoard Gateway using Docker on Linux or Mac OS.


Download Gateway repository and go to the directory:

git clone
cd thingsboard-gateway

Build docker image from Dockerfile:

docker build -t python3-thingsboard-gateway:2.4 docker

Run gateway container from created image

docker run -it -v ~/.thingsboard-gateway/logs:/var/log/thingsboard-gateway -v ~/.thingsboard-gateway/extensions:/var/lib/thingsboard_gateway/extensions -v ~/.thingsboard-gateway/config:/etc/thingsboard-gateway/config --name gateway --restart always python3-thingsboard-gateway:2.4


Detaching, stop and start commands

You can detach from session terminal with Ctrl-p Ctrl-q - the container will keep running in the background.

To reattach to the terminal (to see Gateway logs) run:

docker attach gateway

To stop the container:

docker stop gateway

To start the container:

docker start gateway

Gateway configuration

Stop the container:

docker stop gateway

Configure gateway to work with your instance of ThingsBoard, using this guide:

Start the container after made changes:

docker start gateway