Home Assistant Installation Methods

123 · June 27, 2020, 1:16pm

If you have Supervised installed on Debian, that is the only distro of Linux that is officially supported according to ADR-0014.

github.com

home-assistant/architecture/blob/7f6e6471137ad980d76815bba8e292f010ec3aa8/adr/0014-home-assistant-supervised.md

# 0014. Installation method: Home Assistant Supervised

Date: 2020-06-03

## Status

Accepted

## Context

Define a supported installation method as per [ADR-0012](https://github.com/home-assistant/architecture/blob/master/adr/0012-define-supported-installation-method.md).

## Decision

This installation method provides the full Home Assistant experience on a regular operating system. This means, all components from the Home Assistant method are used, except for the Home Assistant Operating System. This system will run the Home Assistant Supervisor. The Supervisor is not just an application, it is a full appliance that manages the whole system. It will clean up, repair or reset settings to default if they no longer match expected values.

By not using the Home Assistant Operating System, the user is responsible for making sure that all required components are installed and maintained. Required components and their versions will change over time. Home Assistant Supervised is provided as-is as a foundation for community supported do-it-yourself solutions. We only accept bug reports for issues that have been reproduced on a freshly installed, fully updated Debian with no additional packages.

This method is considered advanced and should only be used if one is an expert in managing a Linux operating system, Docker and networking.

This file has been truncated. show original

If you have Supervised installed on some other distro, such as Ubuntu (like I do), then it is not officially supported. What does that mean? It means you will continue to be able to upgrade to new versions of Home Assistant and everything will work, until it doesn’t. When that happens (if ever), you will turn to the community for help because there will likely be other people who are running Supervised on Ubuntu.

If you run Supervised on some obscure distro, if something goes sideways you may have trouble getting community support. For the best support, it’s advisable to select the officially supported distro, namely Debian (as mentioned in the footnotes above).