Home Assistant(Supervisor)安装

发表于 更新于 分类于 ， 阅读次数：

概述

本文讲述 Home Assistant Supervisor 的安装步骤，虽然官方有详细的安装指导，但是由于软件源大都在国外，某些步骤可能需要科学上网才能解决。本文实际部署的硬件平台是 Raspberry Pi 3 Model，请参考 树莓派系统安装 做好硬件和软件环境的准备。

上海天文馆

前期准备

系统确认

参考官方说明文档 Operating System 获取目前支持的系统信息，可知，目前 Home Assistant Supervisor 支持的操作系统类型是 Debian 11 (Bullseye)，参考 树莓派系统安装 完成系统的准备工作。

Apparmor配置

默认树莓派最新的发布版本是安装了 apparmor 工具的，Supervisor 要求系统开机时激活apparmor 服务，需要在/boot/cmdline.txt文件中，追加 apparmor=1 security=apparmor 内容。详细参考 how to enable apparmor 内容。

cgroup配置

打开 /etc/default/grub 文件，如果不存该文件则创建，并在文件中写入 systemd.unified_cgroup_hierarchy=false 内容。

打开 /boot/cmdline.txt 文件，并追加 systemd.unified_cgroup_hierarchy=false 内容。

NetworkManager配置

由于Home Assistant Supervisor 需要 NetworkManager 的支持，而树莓派官方系统默认采用 dhcpcd网络配置工具。所以需要通过raspi-config工具切换网络配置工具。

通过如下命令，打开树莓派配置工具

1
sudo raspi-config

如下图所示，选择 Advanced Options ：

进入后，选择 Network Config ：

最后将网络配置器切换到 NetworkManager，按下回车键 Enter 保存配置，此时需要会提示是否 reboot ,请选择yes，重启树莓派。

Supervisor 安装步骤

依赖软件安装

首先更新系统软件源：

1
2
sudo apt-get update --fix-missing
sudo apt-get upgrade -y

然后通过如下命令安装依赖软件：

1
2
3
4
5
6
7
8
9
10
11
sudo apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
lsb-release \
systemd-journal-remote -y

Docker-CE 安装

下载安装脚本，命令如下：

1
curl -fsSL get.docker.com -o get-docker.sh

国内用户建议通过阿里镜像源进行安装：

1
sh get-docker.sh --mirror Aliyun

将当前用户添加进dockert组中：

1
sudo usermod -aG docker $USER

需要重启才能生效。

OS-Agent 安装

由于Supervisor依赖 OS-Agent 软件包，但该软件不在Debian官方软件源内，需要前往Github仓库 os-agent 下载。

通过如下指令查看芯片架构类型：

1
uname -m

如果输出 aarch64 ，则下载 os-agent_1.4.1_linux_aarch64.deb 软件包。

1
wget -c https://github.com/home-assistant/os-agent/releases/download/1.4.1/os-agent_1.4.1_linux_aarch64.deb

如果网络无法正常下载，可以尝试添加代理，例如如下代理服务：

1
wget -c https://ghproxy.com/https://github.com/home-assistant/os-agent/releases/download/1.4.1/os-agent_1.4.1_linux_aarch64.deb

然后使用 dpkg命令安装：

1
sudo dpkg -i os-agent_1.4.1_linux_aarch64.deb

判断是否安装成功

1
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os

上述命令如果不输出错误信息，而是输出包含 interface 字段的信息则说明安装成功，树莓派安装后输出如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
node /io/hass/os {
  interface org.freedesktop.DBus.Introspectable {
    methods:
      Introspect(out s out);
    signals:
    properties:
  };
  interface org.freedesktop.DBus.Properties {
    methods:
      Get(in  s interface,
          in  s property,
          out v value);
      GetAll(in  s interface,
             out a{sv} props);
      Set(in  s interface,
          in  s property,
          in  v value);
    signals:
      PropertiesChanged(s interface,
                        a{sv} changed_properties,
                        as invalidates_properties);
    properties:
  };
  interface io.hass.os {
    methods:
    signals:
    properties:
      @org.freedesktop.DBus.Property.EmitsChangedSignal("invalidates")
      readonly s Version = '1.4.1';
      @org.freedesktop.DBus.Property.EmitsChangedSignal("true")
      readwrite b Diagnostics = false;
  };
};

Supervisor 安装

前往 Releases · home-assistant/supervised-installer · GitHub下载与 OS-Agent版本匹配的Debian包。

1
wget -c https://github.com/home-assistant/supervised-installer/releases/download/1.4.1/homeassistant-supervised.deb

如果网络无法下载，可以尝试如下代理：

1
wget -c https://ghproxy.com/https://github.com/home-assistant/supervised-installer/releases/download/1.4.1/homeassistant-supervised.deb

执行安装命令：

1
sudo dpkg -i homeassistant-supervised.deb

安装过程中会弹出配置窗口，根据实际硬件和系统位宽选择对应的即可。

1
2
3
4
5
6
7
[info] Install supervisor startup scripts
[info] Install AppArmor scripts
[info] Start Home Assistant Supervised
[info] Installing the 'ha' cli
[info] Within a few minutes you will be able to reach Home Assistant at:
[info] http://homeassistant.local:8123 or using the IP address of your
[info] machine: http://192.168.2.144:8123

安装成功后，需要等待一段时间，时间长短由实际网络情况决定。如果想确认系统是否在运行相关安装操作，可查看系统进程，如果出现下图中的进程，则说明正在下载相关的docker镜像。

通过如下指令可以查看docker镜像的下载情况：

1
docker images | grep ghcr.io/home-assistant

如下镜像列表，说明 Supervisor 需求的所有基础镜像都下载完成。

1
2
3
4
5
6
7
ghcr.io/home-assistant/raspberrypi3-64-homeassistant   2022.12.8   bdb17d6196f1   10 days ago     1.42GB
ghcr.io/home-assistant/aarch64-hassio-supervisor       latest      274d5e89d465   12 days ago     314MB
ghcr.io/home-assistant/aarch64-hassio-cli              2022.11.0   a3ff4e00a9a0   8 weeks ago     116MB
ghcr.io/home-assistant/aarch64-hassio-audio            2022.07.0   c4435f74fa3c   5 months ago    152MB
ghcr.io/home-assistant/aarch64-hassio-dns              2022.04.1   362b749494ab   8 months ago    96.7MB
ghcr.io/home-assistant/aarch64-hassio-multicast        2022.02.0   3ce91958464c   10 months ago   81.5MB
ghcr.io/home-assistant/aarch64-hassio-observer         2021.10.0   9c3593efc7e1   14 months ago   89.2MB

另外可以使用如下命令查看相关容器是否创建成功：

1
docker ps
1
2
3
4
5
6
7
8
CONTAINER ID   IMAGE                                                            COMMAND   CREATED        STATUS        PORTS                                   NAMES
8a35d1671da0   ghcr.io/home-assistant/aarch64-hassio-multicast:2022.02.0        "/init"   21 hours ago   Up 21 hours                                           hassio_multicast
fe5d313af4a6   ghcr.io/home-assistant/aarch64-hassio-audio:2022.07.0            "/init"   21 hours ago   Up 21 hours                                           hassio_audio
af22688c8288   ghcr.io/home-assistant/aarch64-hassio-dns:2022.04.1              "/init"   21 hours ago   Up 21 hours                                           hassio_dns
b5255dbcb17d   ghcr.io/home-assistant/aarch64-hassio-cli:2022.11.0              "/init"   21 hours ago   Up 21 hours                                           hassio_cli
7acff09641e5   ghcr.io/home-assistant/aarch64-hassio-observer:2021.10.0         "/init"   6 days ago     Up 21 hours   0.0.0.0:4357->80/tcp, :::4357->80/tcp   hassio_observer
cb3b24d10901   ghcr.io/home-assistant/raspberrypi3-64-homeassistant:2022.12.8   "/init"   7 days ago     Up 21 hours                                           homeassistant
7e49186c9adf   ghcr.io/home-assistant/aarch64-hassio-supervisor:latest          "/init"   7 days ago     Up 21 hours                                           hassio_supervisor

进一步访问 IP:4357 端口，确认 Supervisor 工作状态是否正常。 supervisor状态

最后通过访问 IP:8123 端口，进行 Home Assisistant 的相关配置，如下图所示，需要等待一段时间，等待系统启动完成，然后创建账户配置基本选项。

参考

  1. supervised-installer: Installer for a generic Linux system

  2. os-agent: Daemon allowing to control OS features through D-Bus

  3. 详解树莓派上如何安装Home Assistant Supervised - 雨月空间站

  4. Network Manager - Home Assistant