This page looks best with JavaScript enabled

How to Install Home Assistant Supervised on a Raspberry Pi 4b – the official way

 ·  ☕ 3 min read  ·  🐧 sysadmin

This video describes how to install Home Assistant Supervised. Home Assistant (former is a container-based system for managing your Home Assistant Core installation and related applications. The system is controlled via Home Assistant which communicates with the Supervisor. The Supervisor provides an API to manage the installation. This includes changing network settings or installing and updating software.

How to Install Home Assistant Supervised on a Raspberry Pi 4b – the official way
# Check the OS
sudo cat /etc/os-release

# Enter your user home directory
cd /home/youruser

# Update the OS
sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

# Fix broken previous installations if any
sudo apt --fix-broken install

# Additionally installl dnsutils to be able to use dig command to any address
sudo apt install dnsutils

# Install necessary tools for the Home Assistant Supervised
sudo apt install jq wget curl udisks2 libglib2.0-bin network-manager dbus apparmor apparmor-utils -y

# See

# For the Raspberry Pi, execute the following to get the official Docker installation script:
curl -fsSL -o

# After that, start the script and enjoy the ride:
sudo sh

# Important! User pi does not exist by default anymore for a security reason

# We have to add our linux user to the Docker group, but that is easy. If your user is not username as in the example below, just change the last part of the command by replacing pi with your username:

sudo usermod -aG docker username

# Add these entries to vim /boot/cmdline.txt at the end of the line: apparmor=1 security=apparmor

sudo vim /boot/cmdline.txt 

# It should look like this: console=serial0,115200 console=tty1 root=PARTUUID=ae7ace51-02 rootfstype=ext4 rootwait apparmor=1 security=apparmor systemd.unified_cgroup_hierarchy=false

# Reboot the server
sudo reboot

# Check AppArmor status
sudo aa-status

# Check versions and compare. See system requirements:

sudo dpkg -l apparmor | tee
sudo docker --version
sudo systemctl --version
sudo nmcli --version

# Install the OS-Agent:
# Download the latest Debian package from OS Agent GitHub release page at:

# Next, install (or update) the downloaded Debian package using:
sudo dpkg -i os-agent_1.2.2_linux_aarch64.deb

# You can test if the installation was successful by running:
sudo 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 the Home Assisistant Supervised Debian Package:

# Next, install (or update) the downloaded Debian package using:
sudo dpkg -i homeassistant-supervised.deb

# Choose: raspberrypi4-64 See supported machine types:

Change DNS entries

sudo vim /etc/dhcpcd.conf
# change the DNS entry to Google and because there was an IP address of the Raspberry Pi that was handling requests through the DNS, but requirements says clearly that it has to be different. See:

interface eth0
static ip_address= 
static routers=
static domain_name_servers=

If you are using the firewall like ufw , add port which Home Assistant is using
sudo ufw allow 8123/tcp

# Reboot the server
sudo reboot

# log into the Home Assistant in your browser
Share on

QA & Linux Specialist