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
cgroup
insource
column
-
-
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.deb
file. 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-64
machine 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.
-
Today, i got an 'unhealthy system - not privileged' - has anyone run across this?
edit - I issued a restart of the supervisor and it resolved the issue, pretty strange but it was okay after -