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)