Home Assistant сам по себе — мощная платформа для умного дома, но его встроенный магазин интеграций покрывает только официально одобренные компоненты. Что делать, если нужное устройство или функция не поддерживается из коробки? Тут на сцену выходит HACS — неофициальный магазин, открывающий доступ к тысячам сторонних интеграций, тем оформления и кастомных карточек для дашборда.

Что такое HACS

HACS (Home Assistant Community Store) — это пользовательская интеграция, которая добавляет в Home Assistant каталог репозиториев от сообщества. Фактически это «App Store» для HA, но бесплатный и с открытым исходным кодом [web_4_0_0_4].

Что позволяет делать HACS:

• Находить и устанавливать пользовательские интеграции — например, для устройств, которых нет в официальном каталоге.
• Добавлять кастомные карточки для Lovelace UI — Mushroom, Button Card, Mini Graph Card и другие.
• Управлять обновлениями сторонних компонентов в один клик.
• Устанавливать темы оформления, Python-скрипты и шаблоны AppDaemon.
• Добавлять кастомные репозитории, не зарегистрированные в каталоге HACS.

На момент 2026 года в каталоге доступно более 3000 репозиториев [web_4_1_0_0]. Проект развивается на GitHub и поддерживается сообществом, а не командой Home Assistant.

Зачем нужен HACS

Встроенный каталог Home Assistant содержит только официальные интеграции, прошедшие проверку. HACS расширяет возможности системы, давая доступ к компонентам, которые:

• Поддерживают устройства, не вошедшие в официальный список — например, пылесосы Dreame, камеры TP-Link Tapo, инверторы Huawei SUN2000.
• Добавляют функции, которых нет в ядре — систему сигнализации Alarmo, отслеживание батарей Battery Notes, расчёт энергопотребления PowerCalc.
• Кастомизируют интерфейс — карточки, темы, боковая панель.

Важно понимать: компоненты из HACS создаются независимыми разработчиками и не проходят официальное тестирование. Популярные интеграции работают стабильно, но при установке малоизвестных компонентов стоит соблюдать осторожность и всегда делать резервную копию [web_4_0_0_2].

Требования для установки

Перед началом установки убедитесь, что у вас есть:

• Запущенный Home Assistant (версии 2024.4.1 или новее).
• Аккаунт на GitHub — он нужен для авторизации HACS и доступа к репозиториям.
• Доступ к терминалу — через аддон Terminal & SSH (для HAOS/Supervised) или через консоль контейнера (для Docker).
• Включённый расширенный режим (Advanced Mode) в настройках пользователя HA.

Если ваш Home Assistant работает на HAOS или Supervised, установить HACS можно через официальный скрипт или через магазин дополнений. Для Docker и Core — через терминал или вручную [web_4_0_0_1].

Способы установки HACS

Выбор способа зависит от типа установки Home Assistant:

Способ 1. Установка на Home Assistant OS (рекомендуемый)

Самый распространённый способ. Подходит для большинства пользователей, запускающих HA на мини-ПК, Raspberry Pi или виртуальной машине с HAOS.

Шаг 1. Включите расширенный режим

1. В левом нижнем углу Home Assistant нажмите на свой профиль пользователя.
2. Найдите переключатель «Расширенный режим» (Advanced Mode) и включите его.

Шаг 2. Установите аддон Terminal & SSH

• Перейдите в Настройки → Дополнения → Магазин дополнений.
• Найдите «Terminal & SSH» (официальный аддон) и установите его.
• В настройках аддона включите «Показывать на боковой панели».
• Запустите аддон и откройте его веб-интерфейс — вы увидите окно терминала.

Шаг 3. Выполните команду установки

В окне терминала вставьте команду (используйте Ctrl+Shift+V для вставки):

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

Скрипт автоматически определит тип установки, создаст папку custom_components/hacs в конфигурационном каталоге и скачает актуальную версию HACS. По завершении вы увидите сообщение «Installation complete» [web_4_0_0_9].

Шаг 4. Перезапустите Home Assistant

Перейдите в Настройки → Система → Перезапустить Home Assistant. Без перезапуска HA не обнаружит новые файлы в папке custom_components.

Шаг 5. Добавьте интеграцию HACS

• Перейдите в Настройки → Устройства и службы.
• Нажмите «Добавить интеграцию» в правом нижнем углу.
• Введите в поиске «HACS» и выберите найденный компонент.
• Прочитайте и отметьте все четыре пункта соглашения (вы понимаете риски, умеете читать логи, будете делать бэкапы). Нажмите «Отправить».

Шаг 6. Авторизуйте HACS через GitHub

1. На экране появится 8-значный код и ссылка на GitHub.
2. Перейдите по ссылке, войдите в свой аккаунт GitHub (или создайте новый).
3. Введите код подтверждения и нажмите «Authorize HACS».
4. Вернитесь в Home Assistant — система сообщит об успешной установке. Нажмите «Готово» [web_4_0_0_9].

После этого в левом меню Home Assistant появится значок HACS. При первом открытии магазину может потребоваться 10–15 минут на загрузку базы данных репозиториев [web_4_0_0_9].

Способ 2. Установка в Docker (Home Assistant Container)

Если вы запускаете HA в Docker-контейнере, магазин дополнений недоступен. Установка выполняется через терминал хост-системы или через консоль контейнера.

Вариант A. Через консоль контейнера

1. Подключитесь к хосту по SSH.
2. Найдите имя контейнера: docker ps
3. Зайдите в контейнер: docker exec -it homeassistant bash
4. Выполните команду установки:

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

1. Выйдите из контейнера: exit
2. Перезапустите контейнер: docker restart homeassistant

Вариант B. Через Portainer

• Откройте Portainer и перейдите в раздел Containers.
• Найдите контейнер Home Assistant и нажмите кнопку «Exec Console» (>_).
• Выберите /bin/bash и нажмите «Connect».
• Выполните команду: wget -O — https://get.hacs.xyz | bash —
• Выйдите из консоли и перезапустите контейнер [web_4_0_0_8].

Далее настройка интеграции HACS выполняется так же, как в способе 1 (шаги 5–6).

Способ 3. Ручная установка

Подходит для Home Assistant Core или случаев, когда скрипт не срабатывает. Процесс требует скачивания файлов вручную и их размещения в нужной директории.

• Скачайте архив последнего релиза со страницы https://github.com/custom-components/hacs/releases/latest.
• Распакуйте архив. Внутри найдёте папку custom_components/hacs.
• Скопируйте папку hacs в директорию custom_components вашего Home Assistant. Если папки custom_components не существует — создайте её рядом с configuration.yaml.
• Перезапустите Home Assistant.
• Добавьте интеграцию HACS через Настройки → Устройства и службы, как описано в способе 1 [web_4_0_0_7].

Способ 4. Установка через магазин дополнений (HAOS/Supervised)

Альтернативный способ для HAOS и Supervised — установка через магазин дополнений. Само дополнение не является HACS, это установщик, который скачивает необходимые файлы.

• Перейдите в Настройки → Дополнения → Магазин дополнений.
• Нажмите на три точки в правом верхнем углу → Репозитории.
• Добавьте ссылку: https://github.com/hacs/addons
• Найдите HACS в списке дополнений и установите его.
• Запустите дополнение и следуйте инструкциям в логах.
• После сообщения «Installation complete» перезапустите Home Assistant.
• Добавьте интеграцию HACS, как описано в способе 1 [web_4_0_0_5].

Популярные интеграции HACS

После установки HACS открывается доступ к тысячам компонентов. Вот наиболее популярные и проверенные сообществом:

Интеграции

Более подробные описания можно найти в каталоге HACS прямо в интерфейсе Home Assistant [web_4_1_0_0][web_4_1_0_2].

Кастомные карточки (Frontend)

Настройка после установки

После установки HACS рекомендуется выполнить несколько шагов:

• Очистите кэш браузера (Ctrl+F5), если HACS не появился в левом меню сразу после перезапуска [web_4_0_0_9].
• Подождите 10–15 минут при первом открытии — HACS загружает базу данных репозиториев.
• Проверьте, что интеграция HACS отображается в Настройки → Устройства и службы без ошибок.
• Установите нужные интеграции через интерфейс HACS: поиск → выбор → кнопка Download.
• После установки новой интеграции через HACS может потребоваться перезапуск Home Assistant — об этом появится уведомление.
• Настройте резервное копирование: перед установкой новых компонентов всегда делайте снапшот.

Типичные проблемы и решения

Безопасность и риски

• HACS — неофициальный проект. Команда Home Assistant не несёт ответственности за компоненты, установленные через него.
• Компоненты из HACS создаются независимыми разработчиками. Качество варьируется от превосходного (популярные интеграции с тысячами пользователей) до экспериментального.
• GitHub-токен, используемый HACS, имеет доступ только на чтение публичных репозиториев. Используйте отдельный токен для HACS, не смешивайте его с другими сервисами [web_4_1_0_7].
• Делайте резервные копии перед установкой новых компонентов. В HAOS/Supervised используйте встроенный механизм снапшотов, в Docker — docker-compose backup.
• Не устанавливайте малоизвестные интеграции с малым количеством звёзд на GitHub, не прочитав их код или хотя бы отзывы [web_4_0_0_2].

Краткий чек-лист установки

• Убедитесь, что Home Assistant версии 2024.4.1 или новее.
• Создайте аккаунт на GitHub (если его нет).
• Включите расширенный режим в настройках профиля HA.
• Установите аддон Terminal & SSH (для HAOS/Supervised).
• Выполните команду: wget -O — https://get.hacs.xyz | bash —
• Перезапустите Home Assistant.
• Добавьте интеграцию HACS: Настройки → Устройства и службы → Добавить → HACS.
• Примите условия соглашения и авторизуйтесь через GitHub.
• Очистите кэш браузера, если HACS не появился в меню.
• Дождитесь загрузки каталога (10–15 минут при первом открытии).
• Установите нужные интеграции и карточки через интерфейс HACS.
• Настройте резервное копирование перед массовыми установками.

Заключение

HACS — это первый «must-have» после установки Home Assistant. Без него вы ограничены только официальными интеграциями, а с ним получаете доступ к огромной экосистеме компонентов от сообщества. Установка занимает 5–10 минут, не требует специальных навыков для HAOS, а результат — полный контроль над тем, какие функции и устройства доступны в вашем умном доме.

Главное правило: один SEO-плагин — один HACS. Не устанавливайте несколько версий, не смешивайте установку через скрипт и через магазин дополнений, и всегда делайте резервную копию перед крупными обновлениями.