Install on AlmaLinux / RHEL

Install ThingsBoard IoT Gateway as an .rpm package on AlmaLinux or RHEL. The package registers the Gateway as a systemd service that starts automatically on boot.

• Python 3.10 or higher is installed.

1. Download the .rpm package.

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

2. Install the package.

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

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. Python 3.11 is supported on AlmaLinux 9.x (9.6 or earlier recommended). AlmaLinux 10 and newer do not provide Python 3.11 in official repositories, and alternative installation methods are not guaranteed to work. If an incompatible Python version is detected, the installer exits with an error.

To install Python 3.11 on AlmaLinux 9.x:

sudo dnf install -y epel-release
sudo dnf install -y python3.11

1. Download the offline .rpm package.

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

2. Install the package.

   sudo dnf install -y ./python3.11-thingsboard-gateway-offline.rpm

3. Check the Gateway status.

   systemctl status thingsboard-gateway

Wrong Python version — the installer exits with an error indicating Python 3.11 is missing. Once Python 3.11 is installed, remove the previously installed package before retrying:

sudo rpm -e --noscripts thingsboard-gateway

Then reinstall the offline package as described above.