树莓派 4（树莓派 3 也可以，如果你身边有一个）。Raspberry Pi 目前很难买到，请使用RPilocator或Fast Alerts（美国）查找有库存的网上商店。
Raspberry Pi 4电源或Raspberry Pi 3 电源
微型 SD 卡。理想情况下，获得应用程序类 2，因为它们处理小型 I/O 比未针对托管应用程序进行优化的卡更一致。建议使用 32 GB 或更大的卡。
SD 读卡器。这已经是大多数笔记本电脑的一部分，但如果您没有，您可以购买独立的 USB 适配器。品牌无所谓，选最便宜的就行。
以太网电缆。安装时需要。安装后，家庭助理可以使用 Wi-Fi，但以太网连接更可靠，强烈推荐。

2.1.2 将映像写入启动媒体

将 Home Assistant 启动媒体（SD 卡）连接到您的计算机
下载并启动Balena Etcher。（您可能需要在 Windows 上以管理员权限运行它）。
选择“从 URL 闪现”
获取 Raspberry Pi 的 URL：

树莓派 4 64 位：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi4-64-7.6.img.xz
树莓派 4 32 位：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi4-7.6.img.xz
树莓派 3 64 位:
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi3-64-7.6.img.xz
树莓派 3 32 位:
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_rpi3-7.6.img.xz

建议使用 64 位）

选择并复制 URL 或使用悬停时出现的“复制”按钮。

将 Raspberry Pi 的 URL 粘贴到 Balena Etcher 中，然后单击“确定”
Balena Etcher 现在将下载图像，完成后单击“选择目标”
选择要用于 Raspberry Pi 的 SD 卡
点击“Flash！” 开始写镜像
当 Balena Etcher 完成图像的写入后，您将收到此确认信息

2.1.3 启动你的树莓派

插入您刚刚创建的启动媒体（SD 卡）。
为网络连接以太网电缆。
连接电源线。
在您的桌面系统的浏览器中，几分钟内您将能够在homeassistant.local:8123上访问您的新家庭助理。

如果您运行的是较旧的 Windows 版本或具有更严格的网络配置，您可能需要通过homeassistant:8123或http://X.X.X.X:8123（将 XXXX 替换为您的 Raspberry Pi 的 IP 地址）访问 Home Assistant。

安装并访问 Home Assistant 操作系统后，您可以继续学习。

2.2 安装家庭助理容器

以下这些说明适用于在您自己管理的容器环境中安装 Home Assistant Container。可以使用任何与OCI兼容的运行时，但是本指南将重点介绍使用 Docker 安装它。

2.2.1 平台安装

使用 Docker 安装很简单。调整以下命令，以便：

/PATH_TO_YOUR_CONFIG指向要存储配置并运行它的文件夹。
MY_TIME_ZONE是一个tz 数据库名称，如TZ=America/Los_Angeles.

安装：
docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=MY_TIME_ZONE \
  -v /PATH_TO_YOUR_CONFIG:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

更新：
# if this returns "Image is up to date" then you can stop here
docker pull ghcr.io/home-assistant/home-assistant:stable
# stop the running container
docker stop homeassistant
# remove it from Docker's list of containers
docker rm homeassistant
# finally, start a new one
docker run -d \
  --name homeassistant \
  --restart=unless-stopped \
  --privileged \
  -e TZ=MY_TIME_ZONE \
  -v /PATH_TO_YOUR_CONFIG:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

一旦 Home Assistant 容器运行 Home Assistant 应该可以使用http://<host>:8123（替换使用系统的主机名或 IP）。您可以继续学习。

2.2.1 重新启动家庭助理

如果更改配置，则必须重新启动服务器。为此，您有 3 个选项。

在您的 Home Assistant UI 中，转到配置面板 ->服务器管理，然后单击“重新启动”按钮。
您可以转到Developer Tools -> Services，选择服务homeassistant.restart并单击“调用服务”。
从终端重新启动它。

Docker CLI：
docker restart homeassistant
Docker Compose：
docker-compose restart

2.2.2 Docker Compose

随着 Docker 命令变得越来越复杂，切换到docker-compose可能更可取，并支持在故障或系统重新启动时自动重新启动。创建一个docker-compose.yml文件：

version: '3'
services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /PATH_TO_YOUR_CONFIG:/config
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

通过运行启动它：

docker-compose up -d

一旦 Home Assistant 容器运行 Home Assistant 应该可以使用http://<host>:8123（替换使用系统的主机名或 IP）。您可以继续学习。

2.2.3 显示设备

为了使用 Z-Wave、Zigbee 或其他需要访问设备的集成，您需要将适当的设备映射到容器中。确保运行容器的用户具有访问/dev/tty*文件的正确权限，然后将设备映射添加到容器指令中：

Docker CLI：
docker run ... --device /dev/ttyUSB0:/dev/ttyUSB0 ...
Docker Compose：
version: '3'
services:
  homeassistant:
    ...
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0

2.2.4 优化

Home Assistant Container 使用替代的内存分配库jemalloc来更好地进行内存管理和 Python 运行时加速。

由于 jemalloc 可能会在某些硬件上引起问题，因此可以通过传递DISABLE_JEMALLOC具有任何值的环境变量来禁用它，例如：

Docker CLI：
docker run ... -e "DISABLE_JEMALLOC=true" ...
Docker Compose：
version: '3'
services:
  homeassistant:
  ...
  environment:
    DISABLE_JEMALLOC: true

错误消息<jemalloc>: Unsupported system page size是一种已知指标。

3. ODROID

3.1 安装家庭助理操作系统

如果您想轻松开始使用 Home Assistant，或者您几乎没有 Linux 经验，请遵循本指南。

3.3.1 推荐的硬件

我们需要做一些事情来开始安装 Home Assistant。下面的链接指向 Ameridroid。如果您不在美国，您应该能够在您所在国家/地区的网上商店中找到这些商品。

首先，我们建议使用 ODROID N2+，它是最强大的 ODROID。它速度快，内置 eMMC，是运行 Home Assistant 的最佳板之一。它也是为我们的Home Assistant Blue提供动力的板。

ODROID N2+
电源供应
CR2032 纽扣电池
eMMC 模块
案子

如果不可用，我们还推荐ODROID C4或ODROID XU4。

3.1.2 将映像写入启动媒体

将 Home Assistant 启动媒体（eMMC 模块/SD 卡）连接到您的计算机

如果您使用的是Home Assistant Blue或 ODROID N2+，您可以直接连接您的设备。
下载并启动Balena Etcher。（您可能需要在 Windows 上以管理员权限运行它）。
选择“从 URL 闪现”
获取您的 ODROID 的 URL：

ODROID-N2：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-n2-7.6.img.xz
ODROID-N2+：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-n2-7.6.img.xz
ODROID-C2：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-c2-7.6.img.xz
ODROID-C4：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-c4-7.6.img.xz
ODROID-XU4：
https://github.com/home-assistant/operating-system/releases/download/7.6/haos_odroid-xu4-7.6.img.xz

3.1.3 启动您的 ODROID

插入刚刚创建的引导介质（eMMC 模块/SD 卡）。
为网络连接以太网电缆。
连接电源线。
在您的桌面系统的浏览器中，几分钟内您将能够在homeassistant.local:8123上访问您的新家庭助理。

如果您运行的是较旧的 Windows 版本或具有更严格的网络配置，您可能需要通过homeassistant:8123访问 Home Assistant或http://X.X.X.X:8123（将 XXXX 替换为您的 ODROID 的 IP 地址）。

安装并访问 Home Assistant 操作系统后，您可以继续学习。

4. Windows视窗

4.1安装家庭助理操作系统

4.1.1 下载相应的图像

虚拟盒子 (.vdi)
KVM (.qcow2)
Vmware 工作站(.vmdk)
Hyper-V (.vhdx)

如果您已经在运行受支持的虚拟机管理程序，请遵循本指南。如果您不熟悉虚拟机，我们建议您直接在Raspberry Pi或ODROID上安装 Home Assistant OS 。

4.1.2 创建虚拟机

将设备映像加载到您的虚拟机管理程序中。（注意：您可以随意为 VM 分配尽可能多的资源，请根据您的附加组件需求分配足够的资源）。

最低推荐任务：

2GB 内存
32GB 存储空间
2vCPU

如果您的使用需要更多资源，所有这些都可以扩展。

4.1.3 管理程序特定配置

虚拟盒子

创建一个新的虚拟机
选择类型“Linux”和版本“其他 Linux（64 位）”
选择“使用现有的虚拟硬盘文件”，从上面选择解压后的VDI文件
编辑虚拟机的“设置”并进入“系统”然后“主板”并选择“启用 EFI”
然后转到“网络”“适配器 1”选择“桥接适配器”并选择您的网络适配器
然后转到“音频”并选择“英特尔高清音频”作为音频控制器。

虚拟机

在中创建一个新的虚拟机virt-manager
选择“Import existing disk image”，提供上面QCOW2镜像的路径
为操作系统选择“通用默认值”
选中“安装前自定义配置”复选框
在“网络选择”下选择您的网桥
在自定义下选择“Overview” -> “Firmware” -> “UEFI x86_64: ...”
单击“添加硬件”（左下角），然后选择“通道”
选择设备类型：“unix”
选择名称：“org.qemu.guest_agent.0”
最后选择“开始安装”（左上角）

VMware工作站

创建一个新的虚拟机
选择“自定义”，使其与 Workstation 和 ESX 的默认值兼容
选择“我稍后会安装操作系统”，选择“Linux”->“其他 Linux 5.x 或更高版本的内核 64 位”
选择“使用桥接网络”
选择“使用现有的虚拟磁盘”并选择上面的VMDK文件，

创建 VM 后，转到“设置”和“选项”，然后“高级”并选择“固件类型”为“UEFI”。

Hyper-V

Hyper-V 不支持 USB

创建一个新的虚拟机
选择“第二代”
选择“连接->“您的桥接虚拟交换机”
选择“使用现有的虚拟硬盘”并从上方选择 VHDX 文件

创建后转到“设置”->“安全”并取消选择“启用安全启动”。

4.1.4 启动您的虚拟机

启动虚拟机
观察 Home Assistant 操作系统的启动过程

完成后，您将能够通过homeassistant.local:8123 联系家庭助理。如果您运行的是较旧的 Windows 版本或具有更严格的网络配置，您可能需要通过homeassistant:8123或http://X.X.X.X:8123（将 XXXX 替换为您的 IP 地址）访问 Home Assistant。

安装并访问 Home Assistant 操作系统后，您可以继续学习。

具体操作可参考：Home Assistant安装之win10上安装VM虚拟机