How to Install Home Assistant Supervised – OFFICIAL WAY

Please help me
When installing Home Assistant Supervised, it returns an error:

[info] Install supervisor Docker container
invalid reference format

Tell me what made a mistake or where to look for information. I have already rummaged through everything that I could, I can not solve this problem (((

So i got everything up and running flawlessly on a Nuc with Debian. Thanks for that!

Updating Home assistant is pretty easy, but what is best practice to update Debian without possible breaking Home assistant? Do i let Home assistant running while i ssh into Debian and update it?
Or stop Home assistant, update Debian and restart the computer? Thanks in advance

thanks for the guide. working well on pi4 64 bit version. however there is a new fire update out and it doesn’t seem to update from supervisor we interface. do we have to do the install script again to get the latest.?

A really cool and easy to follow guide!
Good job, Kiril!
Thanks for that.

Everytin ist woring as expected except one crucrial thing:
Docker is incrementing the spoofed MAC-address afert each reboot.
How do I prevent Docker form doing that and force it to use the same MAC-address forever?

I’m seaching the Internet since days but nothing worked.
Even the –mac-address option didn’t change a thing.

Any ideas that may help?

Yes, installed OS is Rasberry OS (32-Bit) latest release all updates done.

Great guide, many thanks. Quick question I’ve decide to move my HA installation to another device, what’s the best way to remove HA after following your guide?

Many thanks

Thanks for your guide! I was able to install it successfully on my RPi 4!
I have a question now, I’m trying to install the Reolink custom add on using your guide, but I’m unable to find the correct config folder of HA since it’s behind docker. Is there a way to edit the startup docker command to map homeassistant folder to the local file system?
Thanks!

Hi,
I’m using a raspberry pi 4 with pi os buster

I installed following most of the instruction, already had dockers installed with a greater version than requested, 20.10.9, updates & upgrades done

ran the commands:
# sudo apt-get install network-manager apparmor-utils jq -y
# sudo reboot
# sudo curl -Lo installer.sh https://raw.githubusercontent.com/home-assistant/supervised-installer/master/installer.sh
# sudo bash installer.sh –machine raspberrypi4

At the end of the installation it says to connect:
http://192.168.1.132:8123

Only the observer has listening ports:
docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
fb9a411becb9 ghcr.io/home-assistant/armv7-hassio-multicast:2021.04.0 “/init” 21 minutes ago Up 21 minutes hassio_multicast
d33815e8b462 ghcr.io/home-assistant/armv7-hassio-observer:2021.06.0 “/init” 21 minutes ago Up 21 minutes 0.0.0.0:4357->80/tcp, :::4357->80/tcp hassio_observer
7fea187ba5aa ghcr.io/home-assistant/armv7-hassio-cli:2021.09.0 “/init /bin/bash -c …” 22 minutes ago Up 21 minutes hassio_cli
6d5f928ff4dc ghcr.io/home-assistant/armv7-hassio-audio:2021.07.0 “/init” 23 minutes ago Up 23 minutes hassio_audio
7b4bdae7f210 ghcr.io/home-assistant/armv7-hassio-dns:2021.06.0 “/init” 23 minutes ago Up 23 minutes hassio_dns
5c6ec67d686e homeassistant/armv7-hassio-supervisor “/init” 38 minutes ago Up 22 minutes hassio_supervisor

searching for listening ports, no port 8123 also:
netstat -lnt
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address Foreign Address State
tcp 0 0 0.0.0.0:22 0.0.0.0:* LISTEN
tcp 0 0 127.0.0.1:631 0.0.0.0:* LISTEN
tcp 0 0 127.0.0.1:6010 0.0.0.0:* LISTEN
tcp 0 0 127.0.0.1:6011 0.0.0.0:* LISTEN
tcp 0 0 0.0.0.0:4357 0.0.0.0:* LISTEN
tcp6 0 0 :::22 :::* LISTEN
tcp6 0 0 ::1:631 :::* LISTEN
tcp6 0 0 ::1:6010 :::* LISTEN
tcp6 0 0 ::1:6011 :::* LISTEN
tcp6 0 0 :::4357 :::* LISTEN

Only the observer port and page.

Home Assistant observer
Supervisor: Connected

What am I missing?

Thanks in advance

Just installed on a fresh install of raspberry on a pi4, easiest homeassistant install ever. There are 2 things i would add.

1) Disable WiFi mac randomization:

To disable the MAC address randomization create the file
sudo nano /etc/NetworkManager/conf.d/100-disable-wifi-mac-randomization.conf

with the content:
[connection]
wifi.mac-address-randomization=1
[device]
wifi.scan-rand-mac-address=no

2) add apparmor to the Dependence List
sudo apt-get install apparmor

Amazingly clear guide, Kiril – thanks! Now up and running with Home Assistant Supervised on my RPi 4 8GB on Raspberry Pi OS bullseye (only took a few minutes rather than 20 for the initial setup thanks to the default 1.8GHz clock speed now!)

Hello,

What do i pick in the list, when i use a Raspberry Pi Zero 2 W?

Hi, thanks for a great article. 2 thing for the supervised install. 1. Your instructions miss the requirement to install AppArmor. 2. I think there is an issue with app armor and a simple raspberry image. If you reboot the machine and check the logs – it will say AppArmor isn’t running. Same if you do a service apparmor status. I found this comment “I’m guessing you didn’t add lsm=apparmor to cmdline.txt.” on https://github.com/raspberrypi/linux/pull/1698. After adding this entry – I no longer get errors about app armor.

Thanks again

I’ve tried to post a summary step by step that I successfully used, which include a couple of minor changes to the above, but it’s not showing up. Has it been blocked by Akismet?

This worked great on raspberry pi zero 2 w. Used the same agent as this tutorial and installed raspberrypi3 HA-supervised

I posted this question yesterday, don’t know what happened to it, so posting again. I followed your fantastic documentation and ended up with a working Home Assistant installation. However, the “Supervisor” link is missing from the menu. Can you please advise? Thanks!!

Hi Kiril, I have followed your guide and I have installed on my Raspberry4 HA, the only problem is that I have not found the Supervisor menu, is it possible that from November to today something has been changed and that it is necessary to update the guide? hello and congratulations again, ciao from Italy

Thank you for your article, with your help I have managed to get Home Assistant running on an old Raspberry Pi 2 Model B despite being told by everybody that it wouldn’t even install on anything less than a P1 3. My need for Home Assistant is limited to control of heating and lights in an outbuilding and my only Pi 3 is on my 3D printer while I have several Pi 2s available – that and the fact that Amazon has the Pi 4 at £80 to £140, a far cry from the £29.95 I paid for the old ones.

I will now watch your “My YouTube Home Assistant Playlist” as I fit well in the class of people who don’t know what to do next.

Mike

Hi Kiril,
big thanks for your great tutorial!

Now I am standing at the same problem as zablotzky does (3 posts up).

I found a docker-compose.yml file too. But I am wondering how to use it in combination with your tutorial.

Would be great if you could give a hint how to map usb-hardware like a zigbee-stick to the home-assistant container, so you can use it.

Hi, it’s not working for the current version of Raspberry Pi OS 11.
Up until the package installer of Supervised works, afterwards I get an error.
Running this command:
sudo dpkg -i homeassistant-supervised.deb
outputs this error:
dpkg: dependency problems prevent configuration of homeassistant-supervised:
homeassistant-supervised depends on os-agent.

dpkg: error processing package homeassistant-supervised (–install):
dependency problems – leaving unconfigured
Errors were encountered while processing:
homeassistant-supervised

Any idea what could be the problem?

I also made a post about it on reddit.
https://www.reddit.com/r/homeassistant/comments/sp9jzg/ha_supervised_rpi4/?utm_source=share&utm_medium=web2x&context=3

I found possible solution but you can download file but it is empty.
https://www.reddit.com/user/Ramona00/

Ramona00
1 point ·
4 months ago

I just had the same error and resolved it.

The cause is that you’re probably using WiFi as connection. The installer is restarting the network interface and then not waiting for WiFi to reconnect first. Solution, add a delay in the installer script:

First get the installer files

“sudo curl -Lo installer.sh https://raw.githubusercontent.com/home-assistant/supervised-installer/master/installer.sh ”

Then edit the file using VI

“vi installer.sh”

Then navigate to the lines

”

info “Restarting NetworkManager

systemctl restart “${SERVICE_NM}

”

Now add here

info “Delay 20 seconds to give WiFi time to reconnect…..”

“sleep 20″

so:

”
info “Restarting NetworkManager
systemctl restart “${SERVICE_NM}

info “Delay 20 seconds to give WiFi time to reconnect…..”

sleep 20
”

Then save by pressing “:” and then “x” and “enter.

Problem resolved…!

Hi Kiril,

Great work! Thanks for sharing this. I managed to install as per your instructions.

I am trying to grant i2c privilege to Home assistant. What would be the steps to match this configuration.

Thank you, I installed ha supervised by your instructions and everything works fine.
Just a question. My ha reports that the installation is unhealthy and unsupported. What does it mean unhealthy?

Hi Kiril,
great work, well explained. I have HA up and running. Nevertheless, I’m missing an essential part in this installation: I am able to backup my configuration but I couldn’t find any way to restore, since “snapshot” is not avail in my config. Any hints ? Thank you very much !

duo dpkg -i homeassistant-supervised.deb produces:

Leaving ‘diversion of /etc/NetworkManager/NetworkManager.conf to /etc/NetworkManager/NetworkManager.conf.real by homeassistant-supervised’
Leaving ‘diversion of /etc/NetworkManager/system-connections/default to /etc/NetworkManager/system-connections/default.real by homeassistant-supervised’
Leaving ‘diversion of /etc/docker/daemon.json to /etc/docker/daemon.json.real by homeassistant-supervised’
Leaving ‘diversion of /etc/network/interfaces to /etc/network/interfaces.real by homeassistant-supervised’
Unpacking homeassistant-supervised (1.1.1) over (1.1.1) …
Setting up homeassistant-supervised (1.1.1) …
[info] Restarting NetworkManager
[info] Restarting docker service
PING version.home-assistant.io (172.67.68.90) 56(84) bytes of data.
64 bytes from 172.67.68.90 (172.67.68.90): icmp_seq=1 ttl=60 time=34.1 ms

— version.home-assistant.io ping statistics —
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 34.143/34.143/34.143/0.000 ms
Device “eth0
eth0” does not exist.
[info] Install supervisor Docker container
[info] Install supervisor startup scripts
[info] Install AppArmor scripts
[info] Start Home Assistant Supervised
[info] Installing the ‘ha’ cli
grep: /etc/default/grub: No such file or directory
[info] Switching to cgroup v1
cp: cannot stat ‘/etc/default/grub’: No such file or directory
dpkg: error processing package homeassistant-supervised (–install):
installed homeassistant-supervised package post-installation script subprocess returned error exit status 1
Errors were encountered while processing:
homeassistant-supervised

Can anyone help with this? Thank you!

Anyody had the issue to get the docker file issue:

sudo curl -sSL https://get.docker.com | bash
# Executing docker install script, commit: 0221adedb4bcde0f3d18bddda023544fc56c29d1
+ sudo -E sh -c ‘apt-get update -qq >/dev/null’
E: The repository ‘https://download.docker.com/linux/debian bookworm Release’ does not have a Release file.

I tried, did all steps including receiving an answer on os Agent. But I got this error: dpkg: dependency problems prevent configuration of homeassistant-supervised:
homeassistant-supervised depends on os-agent.

dpkg: error processing package homeassistant-supervised (–install):
dependency problems – leaving unconfigured
Errors were encountered while processing:
homeassistant-supervised

For everyone having issues with the “homeassistant-supervised depends on os-agent.”-error, then it can be solved by downloading the correct os-agent.

I had a Raspberry Pi 4 with 64-bit installed, so instead I had to download the os-agent that ended with “aarch64.deb” instead of “armv7.deb”

Hope that helps!

If it is docker under unhealthy is 100% portainer, had one just do it.

Do this:

sudo docker stop portainer
sudo docker restart hassio_supervisor
Update home assistant
sudo docker start portainer

Hi after the cmd udo dpkg -i homeassistant-supervised.deb I am just getting this error and cant succed

Unpacking homeassistant-supervised (1.3.1) over (1.3.1) …
dpkg: dependency problems prevent configuration of homeassistant-supervised:
homeassistant-supervised depends on os-agent.
homeassistant-supervised depends on systemd-journal-remote; however:
Package systemd-journal-remote is not installed.

dpkg: error processing package homeassistant-supervised (–install):
dependency problems – leaving unconfigured
Errors were encountered while processing:
homeassistant-supervised

For anyone using this method still here is what you need
Ubuntu 18.04

When you have downloaded the main installer for ha create a blank folder and move the installer to that folder. Then in a command window go to that folder.

next enter: mkdir tmp
dpkg-deb -R homeassistant-supervised.deb tmp
# edit DEBIAN/preinst and change the following line
BYPASS_OS_CHECK=${BYPASS_OS_CHECK:-false} (that is the old line)
BYPASS_OS_CHECK=${BYPASS_OS_CHECK:-true} (that is the new line)
save the file and exit
from the root of the folder we created at the beginning enter
dpkg-deb -b tmp fixed.deb
then install thee fixed package using dpkg.

Is it possible to use your procedure on a Raspberry Pi 4/8GB with Debian 12 Bookworm installed (see https://raspberrytips.com/install-debian-on-raspberry-pi/)?