This tutorial will enable the use of Home Assistant on an OrangePi 5 board with the following characteristics:
-
OrangePi Debian OS
-
OS running on a SDCard
-
Home Assistant Supervised Instalation
The steps are a compilation with few modifications from instructions found over the web. Links are at the end.
-
Download Debian image from http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-pi-5.html
-
Select latest server release. Bullseye on publication of this tutorial
-
Unzip file and burn it to SDCard.
-
Stick SDCard into board and start it. It takes just a few seconds to complete startup.
-
SSH is enabled by default, you can use it to access. Username: orangepi, Password: orangepi
-
-
Run the following commands as root (
sudo su -). Root passwordorangepi -
Update packages
apt update apt upgrade
-
Install required packages
apt install \ apparmor \ jq \ wget \ curl \ udisks2 \ libglib2.0-bin \ network-manager \ dbus \ lsb-release \ systemd-journal-remote -y
-
Run
orangepi-config-
System → Bootenv. Add the following lines:
extraargs=apparmor=1 security=apparmor systemd.unified_cgroup_hierarchy=0
The lines enable AppArmor and CGroupV1 respectively
-
Save it, then Install
-
Reboot for changes to take effect
-
-
Alternatively you can execute the following commands
echo "extraargs=apparmor=1 security=apparmor" >> /boot/orangepiEnv.txt sed -i -e "1 s/$/ systemd.unified_cgroup_hierarchy=0/" /boot/orangepiEnv.txt update-initramfs -u reboot
-
After reboot, check
-
Apparmor
systemctl status apparmor.service
You should see a line saying
active (excited) -
Cgroup
findmnt -lo source,target,fstype,options -t cgroup,cgroup2
You should see many lines with
cgroupinsourcecolumn
-
-
Run as root
sudo su - -
Install DockerCE
curl -fsSL get.docker.com | sh
-
Install Home Assistant OS Agent
-
Download and install the latest version from https://github.com/home-assistant/os-agent/releases/latest. Look for
aarch64.debfile. For instance:wget https://github.com/home-assistant/os-agent/releases/download/1.5.1/os-agent_1.5.1_linux_aarch64.deb dpkg -i os-agent_1.5.1_linux_aarch64.deb
-
Test instalation by running
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os
Some results in JSON format should be returned
-
-
Install Home Assistant Supervised
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb apt install ./homeassistant-supervised.deb
-
When prompted, select
qemuarm-64machine type. I’m not sure that’s the best option, but it works.
-
-
Just wait until instalation is completed (it should take a few seconds). Some warnings are excpected, since this OS is a custom Debian build.
-
Try to access
http://orangepi5.local:8123. It should work, if not use host IP. If it still doesn’t work reboot machine and try again. If it still doesn’t work, go back to step 1 and review everything.
-
Unfortunately the --fix-broken did not do the trick for me:
root@orangepi3-lts:~# apt install --fix-broken ./homeassistant-supervised.deb
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'homeassistant-supervised' instead of './homeassistant-supervised.deb'
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:
The following packages have unmet dependencies:
homeassistant-supervised : Depends: systemd-resolved
E: Unable to correct problems, you have held broken packages.
root@orangepi3-lts:~#
Any other ideas?