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.
-
@renatoccosta, thank you so much for putting this together. I bought an Orange Pi 5 Plus and used Debian 12 (bookworm), as that's what HA requires now. I ran into two issues/differences which I thought I'd add here for anyone else who runs into this.
Using this similar article focused on Armbian, I was able to bypass the check requiring stock Debian (not Orange Pi Debian). This just required changing the Pretty Name property of the /etc/os-release file to "Debian GNU/Linux 12 (bookworm)". This is a new check that was recently added, and for now, they just check the Pretty Name property in this file. Orange Pi Debian should work just fine (I think).
During installation, I was receiving an error regarding systemd-resolved not being available or not working (I wish I recorded the errors). At first, I tried skipping this check, but that wasn't the right idea. Instead, I just followed the suggestion from the OS to run the supervised install command with the --fix-broken flag, which ended up replacing another package (I don't remember which :) with systemd-resolved.
Thanks!
KC