С версии 2026.11 в Home Assistant встроен магазин сообщества Marketplace - бывший HACS. Через него устанавливают интеграции, карточки и темы сообщества. Для версий 2026.10 и старше HACS устанавливают отдельно.
Что понадобится
Для Marketplace нужна учетная запись администратора Home Assistant. Магазин доступен на любом типе установки начиная с Home Assistant 2026.11, вышедшего 4 ноября 2026 года.
Отдельному HACS на версиях 2026.10 и старше, по требованиям hacs.xyz, нужно больше:
- Home Assistant 2024.4.1 или новее и поддерживаемый тип установки;
- доступ к файлам конфигурации;
- умение открывать лог Home Assistant и включать отладочное журналирование (debug logging);
- стабильный интернет с достаточной полосой, без лимитов трафика и без блокировки исходящих запросов к GitHub и Cloudflare.
Сам HACS ставится как кастомная интеграция - расширение Home Assistant от сообщества. Приложение (app, прежнее название - аддон, add-on) используется для его скачивания на OS и Supervised. Если Home Assistant еще не установлен, начните с установки Home Assistant, а для перехода на свежую версию пригодится обновление Home Assistant.
Установка из Marketplace
Откройте Settings > Marketplace, как указано в документации Marketplace.
Установка проекта
Перед первой установкой или обновлением примите предупреждение кнопкой I understand the risks and agree. Просматривать каталог можно и без согласия. Найдите проект через Search, уточните выдачу через Filters и Sort by. На странице проекта нажмите Install, проверьте предлагаемую версию и подтвердите установку снова кнопкой Install.
Настройка интеграции
Если настройка может начаться сразу, окно откроется автоматически. Иначе выполните задачу, предлагающую перезапуск, в Settings > System > Repairs. Закрытое окно настройки можно снова открыть через Settings > Devices & services.
Карточки
После установки карточки обновите страницу в браузере, затем добавьте карточку на дашборд - панель управления.
Темы
Установленные темы загружаются автоматически, без ручной перезагрузки.
Кастомные репозитории
Для проекта вне каталога используйте Add from link и укажите GitHub link - публичный URL репозитория или запись вида owner/repository. Репозиторию нужны файл hacs.json и поддерживаемая структура. Если система попросит, выберите Type, затем нажмите Add и установите проект.
Обновления
Установленные проекты получают сущности обновления - записи Home Assistant для управления их обновлениями. Читайте примечания к релизам и ставьте обновления в Settings > Updates. После обновления интеграции задача в разделе исправлений предложит перезапустить Home Assistant.
Установка отдельного HACS
Для Home Assistant 2026.10 и старше скачайте и настройте HACS по инструкции hacs.xyz. На 2026.11 и новее отдельная установка HACS заблокирована.
Скачивание на OS и Supervised
Добавьте репозиторий приложений https://github.com/hacs/addons через Settings > Apps > Install app, выберите Get HACS (Home Assistant Community Store) и нажмите Install. Запустите приложение (app, прежнее название - аддон, add-on) и следите за его логами.
Добавление интеграции
Сначала перезапустите Home Assistant. Затем откройте Settings > Devices & services, очистите кэш браузера или обновите страницу с обходом кэша (hard refresh), нажмите + Add integration и найдите HACS (Home Assistant Community Store). Подтвердите показанные утверждения и нажмите Submit. Подробное описание экранов есть в конфигурации HACS.
Вход через GitHub
Скопируйте код устройства и откройте https://github.com/login/device. Войдите в GitHub или создайте учетную запись, введите код, нажмите Continue, затем Authorize HACS (Home Assistant Community Store). После подтверждения вернитесь в Home Assistant.
Завершение настройки
Назначьте HACS зону (area) и нажмите Finish.
Другие способы
Для Home Assistant 2026.10 и старше в установках Container и Core скачайте HACS скриптом из терминала.
Для Container зайдите в работающий контейнер Home Assistant - например, при запуске Home Assistant в Docker - и выполните:
docker exec -it <name of the container running homeassistant> bash
wget -O - https://get.hacs.xyz | bash -Затем перезапустите Home Assistant и добавьте интеграцию HACS, как описано в разделе выше.
Для Core переключитесь на пользователя, под которым работает Home Assistant, и выполните ту же команду загрузки:
wget -O - https://get.hacs.xyz | bash -После этого перезапустите Home Assistant и пройдите настройку интеграции.
Переход со старого HACS
После обновления до 2026.11 Home Assistant автоматически переносит установки из HACS в Marketplace - об этом пишет hacs.xyz.
Ресурсы дашборда переезжают в /local/community/, старые пути /hacsfiles/ продолжают работать. Каталог, репозитории и формат hacs.json остаются прежними, разработка продолжается внутри Home Assistant.
Частые проблемы
В таблице - то, что помогало пользователям форума с отдельным HACS в 2024-2026 годах. Число веток относится к проблеме, а не к подтверждениям каждого решения.
| Проблема | Что помогало пользователям | Веток |
|---|---|---|
| Кастомные карточки дашборда пропали или отмечаются как несуществующие | Поменять URL ресурса, добавив dist. Удалить все ресурсы, перезапуская Home Assistant в процессе, и переустановить карточки по одной из HACS. Убрать или переименовать файл .gz и обновить клиентский ресурс; на Android - принудительно закрыть приложение и очистить его кэш (частично) | 4 |
| HACS не появляется в списке интеграций | Перезагрузить Home Assistant и снова поискать HACS среди интеграций | 3 |
| Установщик HACS или кнопки установки не удается найти | Добавить репозиторий приложения HACS (аддона) в Settings, Apps, Repositories. Действовать по официальной инструкции установки HACS | 3 |
HACS выдает ошибку Error setting up entry for hacs | AttributeError: 'ConfigEntries' object has no attribute 'async_setup_platforms'. Did you mean: 'async_unload_platforms'? | Добавить репозиторий Get HACS, установить и запустить приложение, следить за логами и перезапустить Home Assistant. Удалить HACS и переустановить все заново. Обновить HA OS до 16.2 (частично). Создать новую установку и восстановиться в нее, если существующую обновить не удается | 3 |
Скачивание падает с ошибкой Connecting to raw.githubusercontent.com (0.0.0.0:443)wget: can't connect to remote host (0.0.0.0): Connection refused | Скачать релиз на ноутбук и скопировать файлы через Samba. Добавить DNS-серверы в настройках сети IPv4 и перезапустить HA | 3 |
| Кастомный репозиторий не добавляется или не распознается как интеграция | Добавить репозиторий интеграции в HACS, затем найти и установить его. Добавить связанный репозиторий GitHub | 3 |
| После обновления HACS обновления компонентов трудно найти | Искать обновления в Settings > Updates, обновлять компоненты из Settings | 2 |
Частые вопросы
Нужен ли аккаунт GitHub для Marketplace?
Нет, установка и обновление проектов из каталога работают без аккаунта GitHub. Подключение нужно только для кастомных репозиториев - при первом добавлении Marketplace предложит войти через код устройства и подтвердить соединение на стороне GitHub. Пароль от GitHub в Home Assistant вводить не нужно, подключение читает только публичную информацию и не имеет доступа к приватным репозиториям.
Когда придется править YAML вручную?
Некоторые интеграции требуют настройки через YAML, а ресурсы карточек с подключением через YAML нужно регистрировать вручную. Marketplace сообщит, когда интеграции нужна такая настройка. Для карточки зарегистрируйте ресурс из окна установки. При переходе со старого HACS пользователям, подключавшим ресурсы через YAML, приходит задача с напоминанием.
Пропадут ли установленные из HACS компоненты после обновления?
Нет, установленные компоненты сохранятся. Кастомные репозитории и сущности обновлений перенесутся с сохранением ID сущностей, имен, зон и меток. Сам HACS удалится. Закладки /hacs начнут открывать Settings > Marketplace, а настройки боковой панели HACS исчезнут. Приложения AppDaemon и Python-скрипты сохранят файлы и работоспособность, но потеряют управляемые обновления. Задача в разделе исправлений перечислит такие проекты.
Как включить установленную тему?
Нажмите свое имя внизу боковой панели и выберите тему из числа установленных в выпадающем списке профиля (User profile). Она применяется сразу, а выбор сохраняется на всех устройствах этого пользователя. У каждой учетной записи свой выбор темы, как описано в документации frontend.
