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

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.

Home Assistant Start Page

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
  use_x_forwarded_for: true
  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.


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,

Leave a Reply

Avatar placeholder

Your email address will not be published. Required fields are marked *