Установка HACS в Home Assistant

• Установка HACS
• Обновление токена в HACS

 

HACS — Home Assistant Community Store. Расширение для Home Assistant, в котором собраны дополнения, плагины, темы, разрабатываемые энтузиастами и любителями этой системы автоматизации, своеобразный Marketplace. Установка HACS достаточно проста и не должна вызвать затруднений у пользователей. Документация по установке и настройке есть на официальном сайте HACS.

 

Установка HACS

Для работы с HACS требуется установленный Home Assistant версии не ниже 0.110 и аккаунт на GitHub, поэтому если у вас его нет, то переходим на https://github.com/ и регистрируемся. В аккаунте GitHub переходим в раздел Settings -> Developer settings -> Personal access tokens и генерируем новый токен нажав кнопку Generate new token.

В поле Note вводим описание для чего предназначен создаваемый токен.

Пролистав страницу вниз нажимаем кнопку Generate token.

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

Подключаемся к серверу Home Assistant по SSH. Скачиваемые компоненты должны располагаться в папке .homeassistant/custom_components, если ее нет, то необходимо создать.

 

$ sudo mkdir -p /home/homeassistant/.homeassistant/custom_components/

Скачиваем архив последней стабильной версии, распаковываем его в папку .homeassistant/custom_components/hacs/ и выдаем на нее права пользователю, от которого работает сервис Home Assistant.

Все доступные версии можно посмотреть в разделе проекта на GitHub.

$ sudo wget https://github.com/hacs/integration/releases/latest/download/hacs.zip
$ sudo unzip hacs.zip -d /home/homeassistant/.homeassistant/custom_components/hacs/
$ sudo chown -R homeassistant:homeassistant /home/homeassistant/.homeassistant/custom_components/hacs/

По необходимости удаляем скачанный архив:

$ sudo rm hacs.zip

Перезапускаем Home Assistant.

$ sudo systemctl start homeassistant@homeassistant.service

В Home Assistant добавляем новую интеграцию HACS в разделе Configure -> Integrations -> +. Разработчик HACS рекомендует после установки компонентов очистить кэш браузера, т.к. интеграция бывает, что интеграция не отображается в списке доступных, но может помочь и принудительное обновление страницы по клавише F5.

В открывшемся окне вводим полученный ранее на GitHub токен.

В созданной интеграции HACS нажимаем Options и делаем дополнительные настройки.

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

 

Обновление токена в HACS

Заходим в аккаунт GitHub Settings -> Developer settings -> Personal access tokens, проваливаемся в нужный токен и нажимаем кнопку Regenerate token.

В настройках интеграции HACS я не нашел как можно легко поменять токен, пришлось искать обходной путь.

Останавливаем сервис Home Assistant, открываем файл /homeassistant/.storage/core.config_entries, находим раздел HACS, в поле token заменяем старый токен на вновь сгенерированный.

Запускаем Home Assistant.