131 lines
3.7 KiB
Markdown
131 lines
3.7 KiB
Markdown
### This tutorial will enable the use of Home Assistant on an OrangePi 5 Plus
|
||
|
||
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.
|
||
|
||
1. Download Debian image from
|
||
<http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-5-plus.html>
|
||
|
||
2. Select latest server release. Bullseye on publication of this
|
||
tutorial
|
||
|
||
3. Unzip file and burn it to SDCard.
|
||
|
||
4. 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
|
||
|
||
5. Run the following commands as root (`sudo su -`). Root password
|
||
`orangepi`
|
||
|
||
6. Update packages
|
||
|
||
apt update
|
||
apt upgrade
|
||
|
||
7. Install required packages
|
||
|
||
apt install \
|
||
apparmor \
|
||
jq \
|
||
wget \
|
||
curl \
|
||
udisks2 \
|
||
libglib2.0-bin \
|
||
network-manager \
|
||
dbus \
|
||
lsb-release \
|
||
systemd-journal-remote -y
|
||
|
||
8. Run `orangepi-config`
|
||
|
||
1. System → Bootenv. Add the following lines:
|
||
|
||
extraargs=apparmor=1 security=apparmor
|
||
systemd.unified_cgroup_hierarchy=0
|
||
|
||
The lines enable AppArmor and CGroupV1 respectively
|
||
|
||
2. Save it, then Install
|
||
|
||
3. Reboot for changes to take effect
|
||
|
||
9. 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
|
||
|
||
10. 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
|
||
|
||
11. Run as root `sudo su -`
|
||
|
||
12. Install DockerCE
|
||
|
||
curl -fsSL get.docker.com | sh
|
||
|
||
13. Install Home Assistant OS Agent
|
||
|
||
1. 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
|
||
|
||
2. Test instalation by running
|
||
|
||
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os
|
||
|
||
Some results in JSON format should be returned
|
||
|
||
14. Install Home Assistant Supervised
|
||
|
||
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
|
||
apt install ./homeassistant-supervised.deb
|
||
|
||
1. When prompted, select `qemuarm-64` machine type. I’m not sure
|
||
that’s the best option, but it works.
|
||
|
||
15. Just wait until instalation is completed (it should take a few
|
||
seconds). Some warnings are excpected, since this OS is a custom
|
||
Debian build.
|
||
|
||
1. 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](https://github.com/home-assistant/supervised-installer)
|
||
|
||
- [Home Assistant Comunity
|
||
Forums](https://community.home-assistant.io/t/orange-pi-5-with-home-assistant/498585/17)
|
||
|
||
- [Home Assistant OS
|
||
Agent](https://github.com/home-assistant/os-agent/tree/main#using-home-assistant-supervised-on-debian)
|