Installer Home Assistant Supervised for a generic Linux system
Find a file
Stefan Agner cbae7bc68a Support custom prefix (/usr) and sysconfdir (/etc) (#27)
* use separate variable to specify Docker config location

* use templates and always adjust paths

This prepares for further customization of file locations.

* allow to customize prefix and sysconfdir

Follow GNU directory variable names and allow to specify PREFIX (by
default /usr) and sysconfdir (by default /etc). This allows to install
hassio scripts and service to alternative locations.
2019-07-26 20:52:30 +02:00
.github Create stale.yml 2019-07-15 13:58:55 +02:00
files Support custom prefix (/usr) and sysconfdir (/etc) (#27) 2019-07-26 20:52:30 +02:00
azure-pipelines.yml Fix lint 2019-04-24 13:54:23 +02:00
hassio_install.sh Support custom prefix (/usr) and sysconfdir (/etc) (#27) 2019-07-26 20:52:30 +02:00
LICENSE [skip ci] add licences 2019-04-25 15:23:36 +02:00
README.md Support custom prefix (/usr) and sysconfdir (/etc) (#27) 2019-07-26 20:52:30 +02:00

Build Status

Install Hass.io

Beside the usage of the images it's also possible to run Hass.io on a generic system without flashing an image.

Requirements

docker-ce
bash
jq
curl
avahi-daemon
dbus

Optional

apparmor-utils
network-manager

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 if (docker rm or docker prune) the supervisor will not be able to re-create it for you. Hass.io is a Eco System and Container Orchastrator they don't support manual adjustments.

If you wish to still safelly use docker containers prune you might want 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*"]
}