Home assistant with an unsupported Debian based system

In my case, the server was running: Linux Mint 21.

1. Docker install

curl -fsSL get.docker.com | sh

sudo groupadd docker

sudo usermod -aG docker $USER

newgrp docker

2. Home assistant os agent install

sudo apt install apparmor jq wget curl udisks2 libglib2.0-bin network-manager dbus lsb-release systemd-journal-remote -y

wget https://github.com/home-assistant/os-agent/releases/download/1.5.1/os-agent_1.5.1_linux_x86_64.deb

sudo dpkg -i os-agent_1.5.1_linux_x86_64.deb

3. Verify functionality

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

4. Home assistant Supervised install

wget https://github.com/home-assistant/supervised-installer/archive/refs/tags/1.4.3.zip

4.1 Creating a custom Debian package from the sources of the zip file

Download source code and modify preinst inside DEBIAN folder to contain:

BYPASS_OS_CHECK=true

Fix folder permissions:

sudo chmod 755 homeassistant-supervised/DEBIAN/

4.2 Make a package and install it

dpkg-deb -b homeassistant-supervised

sudo dpkg -i homeassistant-supervised.deb

5. Start homeassistant Docker parts and begin setup via Gui

docker start homeassistant

http://127.0.0.1:8123/onboarding.html

Appendix: Common issues that might appear

Case1: Fix unhealthy system error on homeassistant Gui – if you get one.

docker restart hassio_supervisor

Case2: Ufw is blocking too much.

Modify ufw, make sure this fits to your needs. Replace 192.168.xx.0/24 with your actual values.

sudo ufw allow to 192.168.xx.0/24
sudo ufw allow from 192.168.xx.0/24