Elimina install-ha-opi5.adoc

This commit is contained in:
Fabio 2025-07-04 16:44:35 +08:00
parent 8fe890e858
commit 5b6929ffa0

View file

@ -1,98 +0,0 @@
= 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.
[bibliography]
== References
* https://github.com/home-assistant/supervised-installer[Home Assistant Supervised Installer]
* https://community.home-assistant.io/t/orange-pi-5-with-home-assistant/498585/17[Home Assistant Comunity Forums]
* https://github.com/home-assistant/os-agent/tree/main#using-home-assistant-supervised-on-debian[Home Assistant OS Agent]