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.
Strict requirements
This installation type has some strict requirements as outlined by ADR-0014.
Debian install
- 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
root
user - I don't setup an X environment
- I used the complete disk for provisioning
Configuration
Root user
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 root
user:
sudo su
passwd
Swappiness
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
Info
These are my favorite packages, mixed in with the required packages.
Docker installation
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
Note
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