why ubuntu preferable then HA OS

Ubuntu is a very popular OS with reach functionality and enough long story to trust in security and stability of it.

Install necessary packages

First of all make your system updated:

$ sudo -s
/home/pi# apt update && apt upgrade -y

Please pay attention to installing network-manager which duplicates the functionality of the pre-installed netplan, but strongly required for HA.

apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
systemd-journal-remote -y

As a result you will see similar output:

Restarting services...
Daemons using outdated libraries

  1. dbus.service                 4. rsyslog.service         7. unattended-upgrades.service
  2. multipathd.service           5. ssh.service             8. user@1000.service
  3. networkd-dispatcher.service  6. systemd-logind.service  9. none of the above

(Enter the items or ranges you want to select, separated by spaces.)

Which services should be restarted? 9

My recommendation is to remove netplan and avoid potential problems because of two network managers.

Please don’t forget to backup your netplan configuration if you customized it. Also, you should configure your NetworkManager if customizing is needed.

Run the following commands to remove netplan from your system and enable NetworkManager for autorunning.

sudo apt -y purge nplan
systemctl enable NetworkManager
systemctl start NetworkManager

Home Assistant is distributed as a bunch of docker containers. So, you have to install docker with the following command:

curl -fsSL | sh

Home Assistant requires os-agent. Please pay attention to your platform and version of OS: 64 or 32 bit.

There is the package for x86_64 platform and OS in the example.

Check the latest version with the link.

dpkg -i os-agent_1.4.1_linux_x86_64.deb

Check os-agent installation with following command:

gdbus introspect --system --dest io.hass.os --object-path /io/hass/os

You should see a similar output:

node /io/hass/os {
  interface org.freedesktop.DBus.Introspectable {
      Introspect(out s out);
  interface org.freedesktop.DBus.Properties {
      Get(in  s interface,
          in  s property,
          out v value);
      GetAll(in  s interface,
             out a{sv} props);
      Set(in  s interface,
          in  s property,
          in  v value);
      PropertiesChanged(s interface,
                        a{sv} changed_properties,
                        as invalidates_properties);
  interface io.hass.os {
      readonly s Version = '1.4.1';
      readwrite b Diagnostics = false;

Now you are ready to download and install your Home Assistant:

dpkg -i homeassistant-supervised.deb

You can be faced with the absence of ping in your fresh installed system. In this case HA can’t check the Internet connection and installation will not completed:

/var/lib/dpkg/info/homeassistant-supervised.postinst: line 46: ping: command not found
[info] Waiting for - network interface might be down...

In this case, you have to uninstall HA installation from your system:

dpkg -r --force-all homeassistant-supervised

Install ping to your system:

apt install iputils-ping

Now you have to install HA again:

dpkg -i homeassistant-supervised.deb

And reboot your instance to apply all changes:


Please be aware that your Home Assistant will be unavailable until all necessary docker containers would be deployed to your instance.

The process duration depends on you instance performance and the speed of your Internet connection.

You can check progress by watching log:

tail -f /var/log/syslog

Please wait until you see HA restart in the log:

Stopping homeassistant application#033[0m
Cleaning homeassistant application#033[0m
Home Assistant docker now installed#033[0m
INFO (MainThread) [supervisor.homeassistant.core] Starting Home Assistant#03

Now check that HA is ready for configuration:

netstat -nlp | grep 8123
tcp        0      0  *               LISTEN      3382/python3        
tcp6       0      0 :::8123                 :::*                    LISTEN      3382/python3 

Please be aware that even port is active the installation can be continued with following screen in a web-browser:

After all you should see screen with prompting to setup you Home Assistant local account:

Now, your HA is ready to start your journey in Smart Home world! 

Please feel free to ask any questions in the comments!

Also, you may be interested in the following articles:




Problems and solutions

I was faced with an inability to update HA once during half of year due to an error:

Error updating Home Assistant Core ‘HomeAssistantCore.update’ blocked from execution

 I fixed the issue by reinstalling the HA package with following commands:


dpkg --remove homeassistant-supervised
 dpkg -i homeassistant-supervised.deb 


        1. Unfortunately, I don't understand that does it mean: "if you try to install tu a fresh 22.04.2 it doesn't install".
          I installed HA onto Ubuntu 22.04.2 LTS successfully. HA updates itself with a new versions without problems.
          Is your Ubuntu updated?

          1. I'm having the same problem... Getting the error that Ubuntu 22.04.2 LTS is not supported and it doesn't seem to install.

  1. Tried few versions, went back to 20.04 LTS.
    Same error on all of them:

    sudo dpkg -i homeassistant-supervised.deb
    Selecting previously unselected package homeassistant-supervised.
    (Reading database ... 150326 files and directories currently installed.)
    Preparing to unpack homeassistant-supervised.deb ...
    [warn] If you want more control over your own system, run
    [warn] Home Assistant as a VM or run Home Assistant Core
    [warn] via a Docker container.
    [error] Ubuntu 20.04.6 LTS is not supported!
    dpkg: error processing archive homeassistant-supervised.deb (--install):
    new homeassistant-supervised package pre-installation script subprocess returned error exit status 1
    [info] Undo divert on abort-install

  2. Not working for me.

    Vorbereitung zum Entpacken von homeassistant-supervised.deb ...
    [warn] If you want more control over your own system, run
    [warn] Home Assistant as a VM or run Home Assistant Core
    [warn] via a Docker container.
    [error] Ubuntu 22.04.2 LTS is not supported!
    dpkg: Fehler beim Bearbeiten des Archivs homeassistant-supervised.deb (--install):
    »neues homeassistant-supervised-Skript des Paketes pre-installation«-Unterprozess gab den Fehlerwert 1 zurück
    [info] Undo divert on abort-install
    Keine Umleitung »Umleitung von /etc/NetworkManager/NetworkManager.conf zu /etc/NetworkManager/NetworkManager.conf.real durch homeassistant-supervised«, keine entfernt.
    Keine Umleitung »Umleitung von /etc/NetworkManager/system-connections/default zu /etc/NetworkManager/system-connections/default.real durch homeassistant-supervised«, keine entfernt.
    Keine Umleitung »Umleitung von /etc/docker/daemon.json zu /etc/docker/daemon.json.real durch homeassistant-supervised«, keine entfernt.
    Keine Umleitung »Umleitung von /etc/network/interfaces zu /etc/network/interfaces.real durch homeassistant-supervised«, keine entfernt.
    [info] Resetting debconf selections
    [info] Removal complete, due to the complexity of this installation method,
    [info] you will need to manually remove the containers created by the supervisor
    Fehler traten auf beim Bearbeiten von:

Leave a Reply

Your email address will not be published. Required fields are marked *