Habab Home в Docker: установка на Linux

Доступен preview-образ hababer/habab-home:0.3.6-preview-e787d08f9bc1 для Linux AMD64 и ARM64. Этот тег опубликован в Docker Hub; его публичный digest — sha256:4e73fdbbe91a37917455d1cb95f51c882d7a544216940bde88c21e8131cb3451. Установка, вход владельца, API и сохранение настроек после перезапуска проверены на обеих архитектурах.

Образ основан на Home Assistant Core. Compose сохраняет настройки в постоянном томе /config; владелец создаётся при первом запуске.

Что подготовить

• Linux-сервер с Docker Engine и Compose v2.
• Свободный порт 8123.
• Адрес сервера в домашней сети, если интерфейс нужен с других устройств.
• Интернет для загрузки preview-образа из публичного репозитория Docker Hub.

Compose по умолчанию открывает интерфейс на 127.0.0.1. Для доступа из домашней сети задайте LAN-адрес сервера в HABAB_HOME_BIND и откройте http://АДРЕС-СЕРВЕРА:8123.

Установка

Скачайте compose.release.yaml из выпуска и создайте рядом файл .env:

HABAB_HOME_IMAGE=hababer/habab-home:0.3.6-preview-e787d08f9bc1
HABAB_HOME_BIND=127.0.0.1
TZ=Europe/Moscow

Загрузите образ и запустите контейнер:

docker compose --env-file .env -f compose.release.yaml pull
docker compose --env-file .env -f compose.release.yaml up -d
docker compose --env-file .env -f compose.release.yaml logs -f homeassistant

Откройте http://127.0.0.1:8123 на сервере и создайте владельца в мастере Home Assistant. Для подключения с другого компьютера замените HABAB_HOME_BIND на LAN-адрес сервера, например 192.168.1.20, и пересоздайте контейнер:

docker compose --env-file .env -f compose.release.yaml up -d --force-recreate

При первом старте Home Assistant записывает настройки в Docker volume habab_home_data. Этот том сохраняется при обновлении и пересоздании контейнера. Не добавляйте -v к docker compose down: флаг удаляет том и данные установки.

Настройка чата

После входа владельца откройте чат настройки и выберите AI-провайдера в параметрах Habab Home.

Образ включает интерфейс Habab и OpenCode для выбранной архитектуры. Устанавливать OpenCode на Linux-хост отдельно не нужно.

Обновление

Перед обновлением сделайте резервную копию /config и прочитайте примечания выбранного выпуска. Затем замените тег в .env и скачайте новый образ:

docker compose --env-file .env -f compose.release.yaml pull
docker compose --env-file .env -f compose.release.yaml up -d --force-recreate

Проверьте журнал запуска и откройте Home Assistant. Compose сохраняет том habab_home_data.

Откат

Верните в .env предыдущий тег, который вы записали перед обновлением, и пересоздайте контейнер:

docker compose --env-file .env -f compose.release.yaml pull
docker compose --env-file .env -f compose.release.yaml up -d --force-recreate

Перед обновлением сохраните резервную копию /config и запишите текущий тег образа. Для возврата укажите его в .env и повторите команды Compose.

Устройства и дополнительные сервисы

Настройки Home Assistant хранятся в томе /config. Для Zigbee-координатора добавьте USB-устройство в секцию devices сервиса homeassistant в Compose и выберите его в интеграции. Сетевые интеграции и MQTT подключаются через настройки Home Assistant.

Подключите нужные интеграции и провайдеры в настройках Home Assistant и Habab Home.