Several methods are available to install the gateway:
# Install Theengs Gateway as a pip package
pip install TheengsGateway
You can access advanced configuration by typing:
python3 -m TheengsGateway -h
# Install Theengs Gateway as an Add ON in Home Assistant
- Add the Add-on repository into the add-on store
Or by going to Settings -> Add-ons -> Add-on store -> ⁞ (Menu) -> Repositories -> Fill in the URL
https://github.com/mihsu81/addon-theengsgw -> Add.
- You should now see "TheengsGateway HA Add-on" at the bottom list.
- Click on "TheengsGateway", then click "Install".
- Under the "Configuration" tab, change the settings appropriately (at least MQTT parameters), see Parameters.
- 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:
snap install theengs-gateway
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 pull theengs/gateway
# Advanced users - Build and install
Clone the repository and its submodules:
git clone https://github.com/theengs/gateway.git cd gateway git submodule update --init --recursive
setup.py to a valid version string such has
0.6.0 and then build the package:
python3 setup.py sdist
After this, enter the
dist directory and install the package you built:
cd dist pip3 install TheengsGateway-<version>.tar.gz
When launching the gateway you must be outside of its source code folder to avoid errors