After some reading and compiling several solutions here is what worked for me (HA Docker Supervised on Debian 12 - fresh Debian minimal install with no GUI in Virtualbox). I was able to recreate all the steps several times with success:
-
Log in as root with
sudo -i -
Install dependencies
apt install apparmor jq wget curl udisks2 libglib2.0-bin network-manager dbus lsb-release systemd-journal-remote systemd-resolved -y
- Don’t edit /etc/resolv.conf (I have learned it’s not persistent). Edit /etc/systemd/resolved.conf instead (it’s not so persistant either but it survives first reboot at least).
nano /etc/systemd/resolved.conf
- uncomment DNS to DNS=8.8.8.8 (probably whatever DNS server you prefer.
- I added my router’s IP 192.168.2.1 as FallbackDNS (uncomment it as well and add your router’s IP).
- uncomment ad change DNSStubListener=no
- save the file
!!! OUTSIDE VIRTUALBOX
- run dhclient enp1s0 (your ethernet instance that you get with ip a) - see if this resolves the connection
- you may probably need to install realtek-firmware from USB drive mounted in system
- Check your ethernet bridged connection
nmcli d
Probably your ethernet is unmanaged (in my case enp0s3). Edit /etc/NetworkManager/NetworkManager.conf file
nano /etc/NetworkManager/NetworkManager.conf
and change
[ifupdown]
managed=false
to
[ifupdown]
managed=true
as per https://linuxconfig.org/unmanaged-network-solution-on-debian-linux although it seemed that NetworkManager wasn’t installed on my Debian.
-
Reboot (rebooting through ssh creates an error and the VM closes down and needs to be restarted; rebooting twice in some cases may be necessary).
-
Log in again as root
sudo -i
- Execute commands one at a time:
curl -fsSL get.docker.com | sh
wget https://github.com/home-assistant/os-agent/releases/download/1.6.0/os-agent_1.6.0_linux_x86_64.deb
dpkg -i os-agent_1.6.0_linux_x86_64.deb
- Change folder to [root]/tmp and download installer
cd /tmp
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
and then run the installation
apt install ./homeassistant-supervised.deb
I got no errors with these steps and Home Assistant should be onboarding. But if you get an error that HA couldn’t start (it happend me twice) just restart Docker containter
sudo docker restart homeassistant
and wait a while.
Hope it works for you as well. Or maybe I was just lucky.
![]()