Install on Ubuntu / Raspberry Pi

Install ThingsBoard IoT Gateway as a .deb package on Ubuntu 22.04 LTS / 24.04 LTS or Raspberry Pi. The package registers the Gateway as a systemd service that starts automatically on boot.

• System meets Ubuntu minimum hardware requirements.
• Python 3.10 or higher is installed.

1. Download the .deb package.

   wget https://github.com/thingsboard/thingsboard-gateway/releases/latest/download/python3-thingsboard-gateway.deb

2. Install the package.

   sudo apt install ./python3-thingsboard-gateway.deb -y

   The package automatically installs all required dependencies:

   • System libraries: libffi-dev, libglib2.0-dev, libxml2-dev, libxslt-dev, libssl-dev, zlib1g-dev, python3-dev, python3-pip.
   • Python modules: importlib, importlib-metadata, jsonschema, pymodbus, lxml, jsonpath-rw, paho-mqtt, pyserial, PyYAML, simplejson, pyrsistent.

3. Check the Gateway status.

   systemctl status thingsboard-gateway

4. Configure the Gateway. Follow the configuration guide to connect the Gateway to your ThingsBoard instance. After saving the configuration, restart the service to apply the changes.

   systemctl restart thingsboard-gateway

The Offline Build is a variant of the Gateway package for environments without internet access (air-gapped, firewalled, or private datacenter deployments). It bundles all dependencies in advance, including a prebuilt Python virtual environment, all required Python packages, and the application wheel (.whl), so no runtime downloads are needed and all connectors are immediately available.

The Offline Build requires the same system prerequisites as the standard package, plus Python 3.11 exactly. If an incompatible Python version is detected, the installer exits with instructions for installing the correct version.

To install Python 3.11:

sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt-get update
sudo apt-get install -y python3.11 python3.11-venv

1. Download the offline .deb package.

   wget https://github.com/thingsboard/thingsboard-gateway/releases/latest/download/python3.11-thingsboard-gateway-offline.deb

2. Install the package.

   sudo apt install ./python3.11-thingsboard-gateway-offline.deb -y

3. Check the Gateway status.

   systemctl status thingsboard-gateway

Wrong Python version — the installer displays a guide for installing the required version. Once Python 3.11 is installed, remove the previously installed package before retrying:

sudo dpkg --purge python3-thingsboard-gateway

Then reinstall the offline package as described above.