Home Assistant Supervised - ArchWiki

Jump to content

# Home Assistant Supervised

From ArchWiki

Related articles

- Home Assistant
- AppArmor

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-supervisedAUR package.

And guarantee that AppArmor is correctly installed and configured.

Note

- CGroup v1 is not mandatory anymore since release 3.0.0. So remove the required kernel parameter

`systemd.unified_cgroup_hierarchy=false` for earlier releases.

- The supervised flavor of Home Assistant has been deprecated and will no longer be supported by upstream. See [1]

## Configuration

Supervised configuration files are stored at `/var/lib/homeassistant/`. If no configuration exists, a default configuration will be written at startup. To access just Home Assistant's configuration files go to `/var/lib/homeassistant/homeassistant/`.

### If installed before v3.0.0

Supervised configuration files were changed from `/usr/lib/hassio/` to `/var/lib/homeassistant/`. You can keep the old configuration. You can change the location by setting the data value in the config file `/etc/hassio.json`.

## 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.[2].

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

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

      # docker ps | grep hassio_supervisor

### Supervisor connected but installation Unhealth

1. Check if your AppArmor#Display current status is correctly installed and configured.
2. Check if you start/enable `hassio-apparmor.service` service.
3. 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": "/var/lib/homeassistant"
    }

Categories:

- Servers
- Web applications

Home Assistant Supervised
Add topic