renatoccosta/install-ha-opi5.adoc

## install-ha-opi5.adoc

      
    Raw
  

              install-ha-opi5.adoc
            
          
    Installing Home Assistant on OrangePi 5 Board


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 password orangepi


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 in source 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.


References


Home Assistant Supervised Installer


Home Assistant Comunity Forums


Home Assistant OS Agent