要求
Home Assistant 版本>= 2022.11.0
运行了一个支持的Home Assistant安装包
启用了集成功能
可以访问Home Asssistant配置文件所在的文件系统
知道如何访问Home Assistant log文件
HACS中没有附加组件
有稳定的网络连接没有数据流量的限制

下载安装-脚本模式
a. 前往插件商店 – 配置->加载项->加载项商店
b. 安装SSH附加组件（Terminal & SSH或SSH & Web Terminal）
c. 按照文档配置您选择的SSH附加组件
d. 启动SSH附加组件
e. 连接到SSH附加组件
f. 运行HACS下载脚本
wget -O - https://get.hacs.xyz | bash -
如果出现bad address之类的安装提示，有可能是网络问题，这时可以通过手动下载安装包安装
g. 安装完成后，重启登录，如果看到右侧出现HACS的条目，则说明HACS已经安装成功，需要点击HACS进行github账户授权才能正常使用

手动安装
a. 前往插件商店 – 配置->加载项->加载项商店
b. 安装Samba share
c. 配置Samba share
d. 启动Samba share
e. 下载最新的hacs包：https://github.com/hacs/integration/releases/latest/download/hacs.zip
f. 使用文件管理器访问\HomeAssistantIP\config\custom_components\，输入之前配置的用户名和密码
g. 将下载的hacs.zip解压到\HomeAssistantIP\config\custom_components\路径下
h. 然后重启设备Pi400
g. 重启登录后，如果看到右侧出现HACS的条目，则说明HACS已经安装成功，需要点击HACS进行github账户授权才能正常使用

通过管理员账号执行依赖包安装，HomeAssistant Supervisor采用的是Docker运行方式
su -orsudo su -

apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
lsb-release \
systemd-journal-remote -y

安装Docker-CE

curl -fsSL get.docker.com | sh

安装OS-Agent:
a. 从OS Agent GitHub 发行版页面下载最新的Debian包:
https://github.com/home-assistant/os-agent/releases/latest
b. 安装更新下载的OS-Agent包：
sudo apt install os-agent_1.4.1_linux_aarch64.deb

注意: 替换deb文件名，这里只是个例子，如果是树莓派64位系统，请下载aarch64的deb包
你可以测试安装是否成功:
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os
这里不应该返回错误。如果你得到一个object introspection带interface等内容的。说明OS Agent已经正常工作了。
你可能需要安装libglib2.0-bin去执行gdbus命令。

卸载OS Agent，如果需要卸载

sudo apt-get remove os-agent

安装HomeAssistant Supervised Debain包

wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
apt install homeassistant-supervised.deb #安装下载后的deb包
#安装过程中可能需要对硬件系统进行选择，Pi400+64位系统，这里选择raspberrypi4-64

支持的设备

generic-x86-64
odroid-c2
odroid-c4
odroid-n2
odroid-xu
qemuarm
qemuarm-64
qemux86
qemux86-64
raspberrypi
raspberrypi2
raspberrypi3
raspberrypi4
raspberrypi3-64
raspberrypi4-64
tinker
khadas-vim3

配置
默认的$DATA_SHARE路径是/usr/share/hassio。这个路径是用于存储所有home assistant相关的内容的。
你可以在安装时重新配置这个路径。

DATA_SHARE=/my/own/homeassistant dpkg --force-confdef --force-confold -i homeassistant-supervised.deb
#可以将/my/own/homeassistant替换为自己的路径

故障排查
如果在安装运行过程中出现了错误，使用:
journalctl -f #获取系统的log
如果你不熟悉Linux或者无法修复出现的问题，建议你使用Home Assistant OS。