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.
-
I was just going based off of old youtube videos from when there used to be an icon on the sidebar. But I'm generally good now. Just noob misunderstanding of the UI changes. But you can see that I have addons there so all is well.