# Install
Several methods are available to install the gateway:
# Install Theengs Gateway as a pip package
Prerequisites:
- Install Python3 (opens new window)
- Install pip (opens new window)
Command:
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:
git clone https://github.com/theengs/gateway.git
cd gateway
2
Change version_tag in 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
2
TIP
When launching the gateway you must be outside of its source code folder to avoid errors
← Controller 3 - Use ✈️ →