HACS не появляется в списке интеграций Home Assistant

HACS установлен через Get HACS, но интеграция не появляется в списке Add Integration и в боковой панели Home Assistant. В ветках форума помогала переустановка HACS способом, который соответствует типу установки Home Assistant, или повторный проход настройки в приложении Home Assistant для Apple. В одной ветке интеграция появилась только после второго перезапуска.

Как выглядит проблема

Установка проходит успешно, но интеграции HACS в интерфейсе нет. В ветках форума проблема выглядела так:

  • HACS установлен через Get HACS, но интеграция не появляется ни в списке Add Integration, ни в боковой панели.
  • После установки на Home Assistant Green HACS не появляется в главном меню.
  • На Home Assistant Green после успешной установки HACS нет ни в боковой панели, ни в списке Add Integration.

В логе при этом может встречаться запись:

custom integration hacs which has not been tested by Home Assistant

Проблема встречалась на Home Assistant 2025.6.1 и 2026.8.3. В двух ветках из трех речь шла об установке HA OS; в двух ветках упомянут Home Assistant Green.

Причины

В ветках форума назвали две причины, каждая встретилась один раз. Первую подтвердил сам пользователь, вторая остается предположением.

ПричинаКак проверитьЧто сделать
HACS поставили скриптом для Core-установки вместо аддона для OS, поэтому шаг с аддоном пропущенВспомнить, по какой инструкции шла установка: скрипт для Core или аддон для HA OS. На HA OS нужен был аддонПоставить HACS заново как приложение (app, ранее add-on) по текущей документации; в старом способе с аддоном интеграцию включали в его конфигурации
Первый перезапуск после установки не подхватил интеграцию, со второго она появилась (предположение)Сделать еще один перезапуск Home Assistant и открыть список интеграцийПовторный перезапуск Home Assistant

Если не уверены, какой у вас тип установки Home Assistant, посмотрите гайд по установке Home Assistant.

Что помогло

Решений два, и каждое помогло по одному разу, без сообщений о неудаче.

Поставить HACS аддоном (add-on, теперь app) из магазина и включить интеграцию в его конфигурации. Пользователю Home Assistant Green, который изначально поставил HACS скриптом для Core, помогла именно переустановка аддоном с включением интеграции в конфигурации. Помогло в 1 ветке форума из 1, где пробовали. Способ устарел частично: в текущей документации HACS установщик называется приложением (ранее - аддон), ставится через Settings → Apps → Install app с выбором Get HACS. Актуальные шаги смотрите на странице загрузки HACS.

Повторить настройку HACS в приложении Home Assistant для Apple на MacBook. У одного пользователя форума интеграция появилась после того, как он прошел настройку HACS заново в приложении Home Assistant для Apple на MacBook. Помогло в 1 ветке форума из 1, где пробовали. Опыт единственного пользователя, без подтверждения из других веток.

Если не помогло

Веток, где одно из решений пробовали и оно не сработало, не зафиксировано. Остались три варианта без подтвержденного результата:

  • Пройти настройку интеграции HACS по документации и снова перезапустить Home Assistant. В Home Assistant открыть Настройки → Устройства и службы (Settings → Devices & services), шаг перезапуска описан на странице загрузки HACS. Результат у одного пользователя частичный - инструкция по настройке.
  • Обновить страницу в браузере, чтобы сбросить закешированный экран. Совет с форума, результат неизвестен.
  • Открыть панель HACS напрямую по пути /hacs/dashboard на IP-адресе Home Assistant. Совет с форума, результат неизвестен.

Частые вопросы

Установка завершилась успешно - почему HACS нет в списке?

Успешная установка через Get HACS не гарантирует, что интеграция появится в списке сразу. Пользователи форума описывали ту же картину: установщик завершал работу без ошибок, а HACS не появлялся ни в списке Add Integration, ни в боковой панели. После сообщения об успехе перезапустите Home Assistant и проверьте список еще раз, а если он пуст - ставьте HACS заново способом для вашего типа установки.

Почему в документации приложение, а на форумах аддон?

Потому что документация обновилась, а старые советы остались. Установщик HACS теперь называется приложением (app) и ставится через Settings → Apps → Install app, там выбирается Get HACS. Раньше HACS ставили аддоном (add-on) из магазина аддонов, и на форумах до сих пор используют это название. Оба слова означают один и тот же установщик, различается только терминология и место установки.

Нужно ли включать интеграцию в конфигурации HACS?

В актуальной документации этот шаг не описан. Включение интеграции в конфигурации встречается в старом способе установки через магазин аддонов: этот способ вместе с таким шагом помог одному пользователю форума, у которого HACS не появлялся после установки скриптом. Если ставите HACS приложением, ориентируйтесь на действующую инструкцию из документации.

Первый перезапуск не помог - пробовать второй?

Можно попробовать, но это единичное наблюдение. В одной ветке первый перезапуск после установки через Get HACS не сделал интеграцию видимой, а после второго HACS появился в списке. Это наблюдение одного пользователя, подтверждений из других веток нет. Если второй перезапуск тоже не помог, переходите к переустановке HACS приложением по актуальной документации.

Андрей Ковалев, редактор. Собирает решения из веток форума Home Assistant и сверяет команды и настройки с официальной документацией.