Theengs Gateway: BLE to MQTT bridge

# Install

Several methods are available to install the gateway:

# Install Theengs Gateway as a pip package

Prerequisites:

Make sure to have the latest version of pip if it's already installed:

pip install --upgrade pip
1

Then install Theengs Gateway with:

pip install TheengsGateway
1

You can access advanced configuration by typing:

python3 -m TheengsGateway -h
1

# Install Theengs Gateway as a pip package in a Python virtual environment

Recent versions of Python may prevent you from installing pip packages outside a Python virtual environment. For example, this is the case in Debian 12 ("bookworm"). Install Theengs Gateway then in a virtual environment.

First install pip and the venv module for Python:

sudo apt update
sudo apt install python3-pip python3-venv
1
2

Then create a virtual environment called theengs and activate it:

python3 -m venv theengs
source theengs/bin/activate
1
2

The command prompt is then preceded by (theengs) to show you're working in the virtual environment. Now you can install the Theengs Gateway package:

pip install TheengsGateway
1

After this, you can access advanced configuration by typing:

python3 -m TheengsGateway -h
1

If you want to run Theengs Gateway again in another shell session, don't forget to activate the virtual environment first.

# Install Theengs Gateway as an Add ON in Home Assistant

  1. Add the Add-on repository into the add-on store

Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled. (opens new window)

Or by going to Settings -> Add-ons -> Add-on store -> ⁞ (Menu) -> Repositories -> Fill in the URL https://github.com/mihsu81/addon-theengsgw -> Add.

  1. You should now see TheengsGateway HA Add-on at the bottom list.
  2. Click on TheengsGateway, then click Install.
  3. Under the Configuration tab, change the settings appropriately (at least MQTT parameters), see Parameters (opens new window).
  4. Start the Add-on.

# Install Theengs Gateway as a snap

Theengs Gateway is also packaged as a snap in the Snap Store (opens new window). If you have snapd running on your Linux distribution, which is the case by default on Ubuntu, you can install the Theengs Gateway snap as:

Get it from the Snap Store (opens new window)

snap install theengs-gateway
1

Have a look at the Theengs Gateway Snap (opens new window) documentation for more information about how to configure and start Theengs Gateway as a service.

# Install Theengs Gateway as a docker

Theengs Gateway is also available from docker hub thanks to @maretodoric (opens new window)

Docker Image Size (latest by date) 
docker pull theengs/gateway
1

# Advanced users - Build and install

Make sure to have the latest version of pip:

pip install --upgrade pip
1

Then clone the repository:

git clone https://github.com/theengs/gateway.git
cd gateway
1
2

Then build and install the package:

pip install .
1

TIP

When launching the gateway you must be outside of its source code folder to avoid errors

← 3 - Use ✈️ →