Install Hass.io

As an alternative to using the images which include the HassOS operating system and Docker, it is also possible to run Hass.io on a generic system running another OS of your choice such as Ubuntu, Debian, etc. Because of all the various possible install options, these are more of a community supported installation choice. It follows that the more esoteric of a choice made with the OS, the less a user will find in terms of information and support from the community.

Requirements

docker-ce
bash
jq
curl
avahi-daemon
dbus
network-manager

Important: Don't only install NetworkManager, you need also use it on your system.

Optional

apparmor-utils

Run

Run as root (sudo su):

curl -sL https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh | bash -s

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 -sL https://raw.githubusercontent.com/home-assistant/hassio-installer/master/hassio_install.sh | bash -s -- -m MY_MACHINE

Supported Machine types

intel-nuc
odroid-c2
odroid-xu
orangepi-prime
qemuarm
qemuarm-64
qemux86
qemux86-64
raspberrypi
raspberrypi2
raspberrypi3
raspberrypi3-64
tinker

!!!WARNING!!! DO NOT DELETE CREATED CONTAINERS

This installer will create the base homeassistant container for you, but if you delete it (docker rm or docker prune) the supervisor will not be able to re-create it for you. Hass.io is an Ecosystem and Container Orchestrator and does not support manual adjustments.

If you wish to still safely use docker containers prune it is strongly advised to add the --filter flag to your command.

Example:

$ docker container prune --filter label!=homeassistant

or, for a greater peace of mind, you can add the following config to your ~/.docker/config.json:

{
  "pruneFilters": ["label!=homeassistant", "label!=hassio_supervisor", "label!=addon*"]
}

2.9 KiB Raw Blame History