In this post, I describe how to set up your own Home Assistant with hassio.
Before getting started you have to find an appropriate Hardware Environment to deploy hassio. I would recommend adding a RaspberryPi 3 or 4 to your local infrastructure.
As a precondition to this description, you have to install docker to your hosting system.
To start hassio using docker, execute the following command.
docker run -d --name homeassistant --privileged --restart=unless-stopped -e TZ=Europe/Vienna -v /{PATH}:/config --network=host ghcr.io/home-assistant/home-assistant:stable
I would recommend storing the configuration of the home assistant outside the docker container, by mounting a volume to the configuration folder /config
. Just replace the {PATH}
with the desired location.
The home assistant is now reachable under http://{host}:8123 and ready for configuration.
In order to reach your home assistant outside your network, you can set up a DNS record and a reverse proxy, or directly address the host system. To enable access to hassio using a domain or reverse-proxy, the configurations.yaml
needs to be adjusted as described below, otherwise you will receive an HTTP 400 Bad Request with the following log entry.
A request from a reverse proxy was received from …, but your HTTP integration is not set-up for reverse proxies.
Home Assistant Error Log Entry
# reverse proxy config
http:
use_x_forwarded_for: true
trusted_proxies:
- REVERSE PROXY IP
ip_ban_enabled: true
login_attempts_threshold: 5
Do not forget to restart the docker container after configuration change using docker restart homeassistant
.
After the setup is finished and a user is created, you can start using the home assistant.
The usage is very easy and the web interface is self-explanatory.
Just start to add your devices, sensors, and create some dashboards according to your home automation goals.
2 Comments
Stefan Baumgartnet · 2022 at 6:20
Servus, Sind —privileged und —network=host wirklich notwendig oder reicht es die devices hineinzumappen?
Danke, Stefan
Fabian · 2022 at 12:59
Hi Stefan,
–privileged should not be necessary when you map your devices.
Best regards,
Fabian