Установка Home Assistant Supervised на Debian 12 начинается с проверки разрядности системы и наличия прав root — без 64-битной ОС и доступа к sudo установщик homeassistant-supervised откажется продолжать на этапе настройки пакета. Supervised-версия — это полноценная установка с поддержкой аддонов и Supervisor, но она требует строгого соблюдения условий: «голый» Debian 12 Bookworm, Docker и ряд системных зависимостей. Именно невыполнение этих требований чаще всего приводит к ошибке «unsupported system» в журнале Supervisor.
В этой инструкции разберём подготовку системы, установку Docker, OS-Agent и самого пакета homeassistant-supervised, а также типичные ошибки и способы их диагностики. Материал ориентирован на чистую установку Debian 12 без графического окружения, хотя большинство шагов применимы и к десктопной редакции.
Системные требования и ограничения
Прежде чем приступать, убедитесь, что сервер соответствует официальным требованиям проекта. Supervised-метод поддерживается только на Debian с определённым набором системных компонентов — это зафиксировано в документации Home Assistant, и установщик активно проверяет соответствие.
- 🖥️ Операционная система: Debian 12 Bookworm (64-бит), без других десктопных сред и сторонних сервисов, занимающих нужные порты.
- 🐳 Docker — контейнерная среда, в которой работают Supervisor и все аддоны.
- ⚙️ Системные зависимости:
systemd,NetworkManager,udisks2,apparmor,dbus,jq,curl. - 🌐 Стабильное сетевое подключение — образы контейнеров скачиваются при первом запуске.
- 💾 Запас дискового пространства: образы и данные со временем занимают заметный объём, поэтому маленький корневой раздел — частая причина проблем.
⚠️ Внимание: Supervised-установка предполагает, что машина выделена под Home Assistant. Запуск сторонних сервисов вне Docker может привести к статусу «unsupported», и Supervisor откажется устанавливать аддоны до устранения нарушения.
Подготовка Debian 12 и установка зависимостей
Обновите систему и поставьте необходимые пакеты. Делать это нужно из-под root или через sudo — обычный пользователь без повышенных привилегий не сможет настроить системные службы.
apt update && apt upgrade -y
apt install -y curl wget jq udisks2 libglib2.0-bin network-manager dbus apparmor apparmor-utils
После установки NetworkManager проверьте, что сеть действительно управляется им, а не через классический /etc/network/interfaces. Это одна из самых каверзных точек: если интерфейс описан в interfaces, NetworkManager его игнорирует, а Supervisor позже ругнётся на неподдерживаемую конфигурацию сети. Закомментируйте настройки интерфейса в /etc/network/interfaces и перезапустите службу командой systemctl restart NetworkManager.
Также убедитесь, что AppArmor загружен: проверьте вывод systemctl status apparmor. Если служба неактивна, включите её и перезагрузите сервер — без этого OS-Agent и Supervisor не смогут применять профили безопасности.
Установка Docker
Home Assistant Supervised работает поверх Docker, поэтому следующий шаг — установка контейнерного движка из официального репозитория Docker. Версия из стандартных репозиториев Debian тоже подходит, но официальный пакет обычно свежее и лучше протестирован с Supervisor.
curl -fsSL https://get.docker.com | sh
systemctl enable --now docker
Проверьте результат командой docker run hello-world. Если контейнер скачался и выполнился — движок работает. Убедитесь также, что Docker использует systemd в качестве cgroup-драйвера: в /etc/docker/daemon.json можно явно указать параметр "exec-opts": ["native.cgroupdriver=systemd"], после чего перезапустить службу.
☑️ Готовность системы к установке Supervised
Установка OS-Agent и пакета homeassistant-supervised
OS-Agent — это мост между Supervisor и хост-системой: через него Supervisor управляет сетью, монтированием дисков и системными настройками. Без него установка Supervised невозможна. Пакет распространяется в виде .deb-файла в репозитории проекта на GitHub — скачайте актуальный релиз для вашей архитектуры (amd64, aarch64 и т.д.) и установите его через dpkg.
wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_1.6.0_linux_x86_64.deb
dpkg -i os-agent_1.6.0_linux_x86_64.deb
Имя файла и номер версии могут отличаться — сверяйтесь со страницей релизов OS-Agent, так как версии обновляются. После установки проверьте службу: systemctl status os-agent должен показать активное состояние.
Далее устанавливается сам пакет homeassistant-supervised. Он также берётся из официального репозитория релизов. Во время установки dpkg задаст вопрос о типе машины — для обычного ПК или сервера выбирайте generic-x86-64 (или qemu-x86-64 для виртуальной машины).
wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
dpkg -i homeassistant-supervised.deb
⚠️ Внимание: если установка пакета завершилась ошибкой зависимостей, выполните apt --fix-broken install — apt подтянет недостающие пакеты и завершит конфигурацию. Не удаляйте пакет до попытки автоматического исправления.
После завершения установки Supervisor начнёт скачивать Docker-образы. Это занимает время — в зависимости от скорости канала от нескольких минут до получаса. Веб-интерфейс станет доступен по адресу http://IP_сервера:8123, когда все контейнеры поднимутся.
Проверка работоспособности и типичные ошибки
Когда установка завершена, полезно убедиться, что все контейнеры запущены. Команда docker ps должна показать контейнеры вида hassio_supervisor, hassio_audio, hassio_observer и homeassistant. Если какого-то из них нет, смотрите логи: docker logs hassio_supervisor.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Supervisor пишет «unsupported system» | Не выполнены системные требования | Статус NetworkManager, AppArmor, наличие лишних сервисов |
| Веб-интерфейс недоступен на порту 8123 | Образы ещё скачиваются или контейнер упал | docker ps и логи контейнера homeassistant |
| Ошибка при установке OS-Agent | Неверная архитектура пакета | Вывод dpkg --print-architecture и имя скачанного файла |
| Служба os-agent не стартует | Проблемы с D-Bus или зависимостями | journalctl -u os-agent |
| Supervisor жалуется на сеть | Интерфейс не под управлением NetworkManager | Содержимое /etc/network/interfaces |
Отдельно стоит сказать про статус «healthy» в Supervisor: пока система помечена как unsupported или unhealthy, обновления и установка аддонов блокируются. Поэтому игнорировать предупреждения в разделе «Настройки → Система → Обслуживание» не стоит — они напрямую влияют на работоспособность установки.
Чем Supervised отличается от Home Assistant OS и Container
Home Assistant OS — готовый образ со своей операционкой, ставится на отдельное устройство или ВМ. Container — только ядро в Docker, без Supervisor и аддонов. Supervised — компромисс: полный функционал с аддонами, но на вашем Debian, который вы обслуживаете сами.
Обновление и обслуживание установки
Supervised-установка обновляется из веб-интерфейса: Supervisor сам подтягивает новые версии Home Assistant и аддонов. Ваша зона ответственности — хост-система: регулярно выполняйте apt update && apt upgrade, следите за обновлениями Docker и OS-Agent. Пакет homeassistant-supervised тоже периодически обновляется — новые версии публикуются в том же репозитории релизов.
Перед обновлением хоста имеет смысл создать снапшот в интерфейсе Home Assistant (Настройки → Система → Резервные копии) и скопировать его на внешнее хранилище. Это позволит быстро откатиться, если после обновления Debian что-то сломается.
Часто задаваемые вопросы
Можно ли установить Home Assistant Supervised на Ubuntu или Debian 11?
Официально поддерживается только Debian. На Ubuntu установка возможна, но система получит статус unsupported, и Supervisor может ограничить функциональность. Для Debian 11 стоит сначала обновиться до 12 или выполнить чистую установку.
Что делать, если веб-интерфейс не открывается после установки?
Проверьте, что контейнеры запущены: docker ps. Если список пуст или неполный, смотрите логи Supervisor командой docker logs hassio_supervisor. Частая причина — медленное скачивание образов или сбой сети; подождите и проверьте снова.
Нужен ли отдельный пользователь для Home Assistant?
Нет. Установка выполняется от root, а сами компоненты работают внутри Docker-контейнеров. Создавать отдельного системного пользователя не требуется.
Можно ли перенести Supervised-установку на другой сервер?
Да. Создайте полную резервную копию в интерфейсе Home Assistant, разверните Supervised на новой машине по этой инструкции и восстановите бэкап при первой настройке или через раздел резервных копий.
Почему Supervisor пишет «unhealthy system» и блокирует обновления?
Обычно это связано с нарушением системных требований: неактивный AppArmor, сеть вне NetworkManager, проблемы с Docker или сторонние контейнеры. Откройте раздел «Настройки → Система → Обслуживание» — там перечислены конкретные причины, устраните их и перезапустите Supervisor.