/supervised-installer

Installer for a generic Linux system

Primary LanguageShellApache License 2.0Apache-2.0

This installation method is for advanced users only

Make sure you understand the requirements

Install Home Assistant Supervised

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.

Installation

Run as root (sudo su):

curl -Lo installer.sh https://raw.githubusercontent.com/home-assistant/supervised-installer/master/installer.sh
bash installer.sh

Command line arguments

argument default description
-m | --machine On a special platform they need set a machine type use
-d | --data-share $PREFIX/share/hassio data folder for hass.io installation
-p | --prefix /usr Binary prefix for hass.io installation
-s | --sysconfdir /etc Configuration directory for hass.io installation

you can set these parameters by appending --<parameter> <value> like:

curl -Lo installer.sh https://raw.githubusercontent.com/home-assistant/supervised-installer/master/installer.sh
bash installer.sh --machine MY_MACHINE

Supported Machine types

  • generic-x86-64
  • odroid-c2
  • odroid-n2
  • odroid-xu
  • qemuarm
  • qemuarm-64
  • qemux86
  • qemux86-64
  • raspberrypi
  • raspberrypi2
  • raspberrypi3
  • raspberrypi4
  • raspberrypi3-64
  • raspberrypi4-64
  • tinker
  • khadas-vim3

Troubleshooting

If somethings going wrong, use journalctl -f to get your system logs. If you are not familiar with Linux and how you can fix issues, we recommend to use our Home Assistant OS.