Установка магазина HACS в Home Assistant: пошаговый гид

Установка Home Assistant Community Store (HACS) — это важнейший шаг для любого владельца умного дома, который хочет выйти за рамки стандартных возможностей системы. HACS представляет собой неофициальный каталог дополнений, интеграций, тем оформления и карточек для интерфейса Lovelace, созданных активным сообществом разработчиков. Именно через этот магазин устанавливается популярная интеграция для работы с голосовым ассистентом Алисой.

Стандартный Home Assistant поддерживает сотни устройств из коробки, однако множество кастомных интеграций для российских реалий (таких как локальные компоненты для пылесосов, увлажнителей или интеграции с провайдерами ЖКХ) доступны исключительно через HACS. Без этого инструмента ваш Умный Дом будет сильно ограничен в гибкости и кастомизации.

Подготовка к установке HACS

Перед тем как приступить к процессу интеграции, убедитесь, что ваш сервер Home Assistant соответствует базовым техническим требованиям. Для успешной установки вам понадобятся:

1. Запущенный сервер Home Assistant (рекомендуется официальная сборка Home Assistant OS или Supervised). Если вы используете контейнер Docker (Core-версию), вам потребуется прямой доступ к каталогу настроек custom_components вашего сервера.
2. Локальный компьютер, находящийся в той же локальной сети, что и ваш сервер умного дома.
3. Аккаунт на платформе GitHub. Он необходим для прохождения аутентификации и загрузки файлов с репозиториев разработчиков. Если аккаунта нет, зарегистрируйте его заранее на официальном сайте.
4. Доступ к интерфейсу командной строки (SSH) или установленный аддон Advanced SSH & Web Terminal в веб-интерфейсе Home Assistant.

Пошаговый процесс установки

Процесс состоит из нескольких логических этапов: загрузки файлов на сервер, перезапуска ядра системы и последующей настройки интеграции через веб-интерфейс.

Шаг 1. Подключение по SSH и выполнение команды

Если вы используете операционную систему Home Assistant OS, самый простой способ выполнить установку — использовать терминал прямо внутри веб-интерфейса.

1. Откройте панель управления Home Assistant, перейдите в раздел Настройки ➡️ Дополнения ➡️ Магазин дополнений.
2. Найдите в поиске и установите аддон Terminal & SSH или Advanced SSH & Web Terminal. Перед запуском убедитесь, что в настройках аддона включен пункт «Показывать на боковой панели».
3. Запустите аддон и откройте окно терминала.
4. Введите следующую команду для автоматической загрузки скрипта установки:

   wget -O - https://get.hacs.xyz | bash -

5. Нажмите клавишу Enter. Скрипт автоматически определит тип вашей установки, создаст необходимую папку custom_components/hacs в корневом каталоге и загрузит туда актуальные файлы последней стабильной версии магазина.

Шаг 2. Перезагрузка Home Assistant

После завершения работы скрипта в терминале появится сообщение об успешной загрузке. Теперь систему нужно перезапустить, чтобы она смогла просканировать папку с компонентами и обнаружить HACS.

1. Перейдите в раздел Настройки ➡️ Система.
2. В верхнем правом углу нажмите на иконку перезагрузки (или кнопку Перезапуск в подразделе управления сервером).
3. Выберите Перезапустить Home Assistant и подтвердите действие.
4. Дождитесь, пока веб-интерфейс снова станет активным. Обычно это занимает от 30 до 90 секунд в зависимости от мощности вашего сервера.

Шаг 3. Добавление и авторизация интеграции

Теперь переходим к финальной настройке в графическом интерфейсе Home Assistant.

1. В левом меню выберите Настройки ➡️ Устройства и службы.
2. В правом нижнем углу нажмите кнопку Добавить интеграцию.
3. Введите в строке поиска HACS и выберите найденный компонент.
4. Перед вами откроется окно с предупреждениями безопасности. Вам нужно будет внимательно прочитать и отметить галочками все четыре пункта соглашения (подтверждение того, что вы понимаете риски использования стороннего кода, знаете, как читать логи при сбоях и обязуетесь делать бэкапы). Нажмите Отправить.
5. На экране появится уникальный 8-значный код верификации и ссылка на страницу активации GitHub. Скопируйте этот код.
6. Перейдите по указанной ссылке на сайт GitHub, войдите под своей учетной записью и вставьте скопированный код. Подтвердите предоставление прав для приложения HACS.
7. Вернитесь в Home Assistant. Окно интеграции обновится автоматически, и система сообщит об успешном завершении настройки. Нажмите Готово.

Что делать после установки

После успешной интеграции на боковой панели Home Assistant появится новый раздел HACS. При первом открытии магазину может потребоваться до 15-20 минут на первоначальную загрузку полной базы данных репозиториев. В это время разделы «Интеграции» и «Интерфейс» могут казаться пустыми — это абсолютно нормально, не паникуйте.

Используя HACS, вы сможете легко подключить ваш дом к экосистеме Яндекса. Для завершения связки устройств и настройки голосового управления через Яндекс Станцию изучите подробную инструкцию по настройке интеграции Home Assistant с облаком Яндекса, где подробно описан процесс проброса всех ваших датчиков, выключателей и умных ламп напрямую в приложение Умный Дом с Алисой. В ней рассказывается о получении токенов доступа, настройке конфигурационных файлов и синхронизации комнат, чтобы Алиса понимала, где находится каждый прибор.