Home Assistant Supervised
Possibly out of date
I don't use this installation type anymore, but this documentation is only kept for others / future reference.
This installation type has some strict requirements as outlined by ADR-0014.
- Download Debian. I chose the non-free firmware repo for maxmimum compatibiliy. This version of Debian contains proprietary kernel modules needed for network connectivity.
- Put Debian on removable media (eg. thumb drive)
- Install Debian
- I use a Network Install
- I've not setup the
- I don't setup an X environment
- I used the complete disk for provisioning
We didn't set up a
root user during install. This is fine, since we can simply use
sudo, but prevents us from getting into safe mode when 💩 hits the fan. So we set up a password for the
sudo su passwd
I lower the swappiness for a more responsive system:
sudo sysctl -w vm.swappiness=5 sudo echo "vm.swappiness=5" >> /etc/sysctl.conf
This will ensure that less of swap is used. You can test if the setting applied correctly:
sysctl vm.swappiness cat /etc/sysctl.conf
Additional / required packages
sudo apt update sudo apt install -y aptitude apparmor bash curl dbus dnsutils \ git htop jq libglib2.0-bin lsb-release ncdu \ nmon network-manager socat sshpass \ systemd-journal-remote udisks2 vim wget
These are my favorite packages, mixed in with the required packages.
sudo -s curl -fsSL get.docker.com | sh
Install Home Assistant OS Agent
You'll need to download the latest release from GitHub.
sudo -s sudo dpkg -i os-agent_1.0.0_linux_x86_64.deb
Change the version number to the downloaded version
You can test if the installation was successful by running:
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os
This should not return an error. If you get an object introspection with interface etc. OS Agent is working as expected.
Install Home Assistant
Finally we can download and install Home Assistant:
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb apt install ./homeassistant-supervised.deb