Overview
- Full name
docker.io/homeassistant/armhf-homeassistant- Registry
- docker.io
- Namespace
- homeassistant
- Repository
- armhf-homeassistant
- Cached tags
- 3544
- Last synced
- 07/06/2026, 01:56 PM
- Topics
Introduction
Home Assistant 官方 ARM32（armhf）镜像，面向树莓派等嵌入式板卡运行智能家居中枢，依赖本地硬件与 Zigbee/Z-Wave USB 设备。
Details
homeassistant/armhf-homeassistant 为 32 位 ARM 设备优化的 Home Assistant Core/OS 容器，集成自动化、实体管理与 hundreds of integration。典型部署在树莓派 3/4 armhf 系统，/config 目录保存 YAML 与 UI 配置。与 amd64 镜像相比仅适用于 armhf 主机；不适合常规 x86 Kubernetes 集群，且常需 --device 挂载 USB 协调器与 host 网络发现 mDNS 设备。
快速启动
docker run -d --name homeassistant \
--network host \
-v /data/homeassistant:/config \
docker.io/homeassistant/armhf-homeassistant:latest
推荐实践
docker run -d --name homeassistant \
--restart unless-stopped \
--network host \
-v /data/homeassistant:/config \
--device /dev/ttyUSB0 \
-e TZ=Asia/Shanghai \
docker.io/homeassistant/armhf-homeassistant:2024.11.0
核心参数说明
--network host— 发现局域网 IoT 设备（mDNS/SSDP）-v .../config:...— 配置、自动化与数据库--device /dev/ttyUSB0— Zigbee/Z-Wave USB dongle-e TZ— 定时自动化时区--restart unless-stopped— 家庭中枢持续运行- 架构 — 仅 armhf，勿在 amd64 节点拉取