Habab Home на Raspberry Pi: установка без Docker

Для нативной установки Habab Home используйте Raspberry Pi с 64-разрядной Ubuntu Server 26.04 LTS. Установщик рассчитан на ARM64 и Python 3.14.2 или новее — эту версию требует Home Assistant Core 2026.10.2.

Инсталлятор работает через SSH, создаёт systemd-службу и устанавливает Home Assistant Core в отдельное окружение Python. Docker не нужен ни при установке, ни во время работы. Конфигурация Home Assistant хранится отдельно от версий программы, поэтому обновление и откат не стирают configuration.yaml и автоматизации.

Статус сборки

Доступен Linux ARM64 preview 0.3.6. В комплект входят установка без Docker, мастер создания владельца, веб-интерфейс, OpenCode и служба systemd.

Что понадобится

• Raspberry Pi 4 или 5 с ARM64 Ubuntu Server 26.04 LTS.
• Raspberry Pi 4/5 с RAM от 4 ГБ и SSD от 64 ГБ.
• Питание: официальный USB-C блок Raspberry Pi 4 на 5 В / 3 А; для Raspberry Pi 5 — официальный блок 27 Вт USB-C. Для SSD и USB-координаторов проверьте потребление; при нехватке питания используйте USB-хаб с отдельным питанием.
• Сетевое подключение и SSH-доступ с учётной записью администратора.
• Python 3.14.2 или новее; установщик проверяет версию до установки.
• Ethernet рекомендуется для установки и работы домашнего сервера; после настройки Wi-Fi зависит от вашей сети.
• Интернет при установке и для интеграций, которым требуется внешнее подключение.

Используйте соответствующий USB-C блок питания: 5 В / 3 А для Raspberry Pi 4 или 27 Вт для Raspberry Pi 5. Подробности есть в документации Raspberry Pi.

Установка по SSH

Подключитесь к плате командой ssh имя_пользователя@IP_АДРЕС и скачайте архив с контрольной суммой. Затем распакуйте пакет и запустите установщик:

curl -fLO https://github.com/marsiandeployer/habab-home-assistant/releases/download/linux-0.3.6-preview-e787d08f9bc1/habab-home-linux-arm64-e787d08f9bc1.tar.gz
curl -fLO https://github.com/marsiandeployer/habab-home-assistant/releases/download/linux-0.3.6-preview-e787d08f9bc1/SHA256SUMS
sha256sum --check SHA256SUMS
tar -xzf habab-home-linux-arm64-e787d08f9bc1.tar.gz
bash payload/linux/install.sh

Архив занимает 108 340 481 байт, SHA-256: 1dc497931678856d87fd2220fd83a1b0efe6d7ea0112dabec3fa98997d0f3fbc. При установке дополнительно скачиваются Home Assistant и зависимости; место для истории и резервных копий нужно отдельно.

Установщик проверит ОС, архитектуру и Python, загрузит Home Assistant Core, подготовит каталоги приложения, установит systemd-службу и запустит её.

Когда служба станет доступна, откройте в локальной сети http://IP-АДРЕС-RASPBERRY-PI:8123 и завершите первоначальную настройку Home Assistant. После этого добавьте устройства и интеграции обычным способом через интерфейс Home Assistant.

Где находятся данные

Постоянная конфигурация находится в /var/lib/habab-home/config. Версии Home Assistant и Habab Home хранятся в /opt/habab-home/releases; ссылка current указывает на активную версию. Служба habab-home.service запускает Home Assistant при старте Ubuntu.

Для доступа к USB-координатору Zigbee подключайте его к Raspberry Pi. Установщик добавляет служебного пользователя в группу dialout; после добавления устройства проверьте его путь в Home Assistant. Совместимость конкретного адаптера зависит от его драйвера и прошивки.

Подключение к домашней сети

После установки откройте интерфейс по локальному адресу платы http://IP-АДРЕС-RASPBERRY-PI:8123. Для USB-координатора Zigbee подключите его к Raspberry Pi и выберите устройство в настройках интеграции.