Home Assistant Supervised

Home Assistant is an open source home automation software that puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts. Supervised is a type of installation that provides the ability to use more features, like Addons installation from UI.

Install

Install the homeassistant-supervised^AUR package.

And guarantee that AppArmor is correctly installed and configured.

Also set the following kernel parameter:

systemd.unified_cgroup_hierarchy=false

Configuration

Supervised configuration files are stored at /usr/share/hassio/. If no configuration exists, a default configuration will be written at startup. To access just Home Assistant"s configuration files go to /usr/share/hassio/homeassistant/.

Usage

To start Home Assistant, start/enable hassio-apparmor.service and hassio-supervisor.service.

The first start may take up to 20 minutes because the required packages will be downloaded and installed.[1].

By default, the web interface is available at http://localhost:8123.

Troubleshooting

Before doing anything, check if supervisor is Connected and the installation Healthy. You can do that by accessing the Observable Plugin, which can be accessed at http://localhost:4357.

Supervisor not connected

Check if hassio-supervisor.service is started/enabled.
Check if your supervisor container is up and running.

# docker ps | grep hassio_supervisor

Supervisor connected but installation Unhealth

Check if your AppArmor#Display current status is correctly installed and configured.
Check if the kernel parameter is correctly configured.
Check if you start/enable hassio-apparmor.service service.
Look at Supervisor logs for additional information:

# docker logs -f hassio_supervisor

file /etc/hassio.json does not exist

Make sure you have the /etc/hassio.json configuration file.

If not, create it and fill it with sample data:

{
    "supervisor": "ghcr.io/home-assistant/amd64-hassio-supervisor",
    "machine": "generic-x86-64",
    "data": "/usr/share/hassio"
}