Instalación HACS en Home Assistant

Que es HACS

HACS es una tienda de integraciones y plugins para Home Assistant mantenida por la comunidad de usuarios, en ingles Home Assistant Comunity Store (HACS)

En HACS se pueden encontrar integraciones que no están entre las oficiales de Home Assistant, asi como integraciones que si están en las oficiales, pero que tienen mas funcionalidades.

Entorno de instalación

La instalación de HACS se base en la ejecución de un scripts en la linea de comandos del servidor donde está instalado el Home Assistant, de tal forma, que dependiendo de la instalación se debería realizar unos pasos u otros, los pasos son bastantes parecidos, difieren fundamentalmente en el paso para entrar en la consola donde ejecutar el comando de instalación.

En este tutorial se seguirán los pasados para la instalación de HACS en un Home Assistant ejecutado en un contenedor de Docker, se ha seguido la documentación oficial que se encuentra en la página de descargas de HACS

Prerrequisitos

Para realzar la instalación de HACS deberemos previamente cumplir los requisitos. En el momento de escribir el artículo, a nivel de versión de Home Assistant debe ser una versión igual o superior a la 2022.04.0.

Las instalaciones de los plugins en HACS se basan en repositorios de GitHub, nos pide tener una cuenta en GitHub y durante la configuración nos pedirá que le demos permisos para usar la cuenta, de tal forma, que deberemos tener previamente una cuenta en GitHub

Pasos instalación

Nos conectares al servidor que contiene el contenedor de docker del Home Assistant y localizamos el hombre del contenedor, para eso se puede ejecutar el siguiente comando

[~] # docker ps -f name=home
CONTAINER ID   IMAGE                                 COMMAND                  CREATED        STATUS        PORTS     NAMES
a010c886dceb   homeassistant/home-assistant:latest   "/init python -m hom…"   19 hours ago   Up 14 hours             home-assistant

En mi caso he filtrado por el nombre de los contenedores que comienzan por home, si no se conoce nada del nombre, se puede quitar el parámetro -f dejando el comando solo con docker ps

Entraremos en el contenedor:

[~] # docker exec -it home-assistant /bin/bash
bash-5.1# 

Si se dispone un gestor de contenedores u orquestador se puede acceder a la consola desde el, por ejemplo, para el caso de Portainer sería siguiendo los siguientes pasos:

En le menú «Containers» haremos click en el acción «Exec Commands» del contenedor del Home Assistant

Dejaremos los datos por defecto de la ventana de configuración y pulsaremos en Connect

Se nos mostrará la ventana de la consola de contenedor

Una vez en la consola, ejecutamos el comando de instalación

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

El log de instalación será algo parecido a lo siguiente

bash-5.1# wget -O - https://get.hacs.xyz | bash -
Connecting to get.hacs.xyz ([2a06:98c1:3120::5]:443)
Connecting to raw.githubusercontent.com ([2606:50c0:8003::154]:443)
writing to stdout
-                    100% |**************************************************************************************************************************************************************************************************|  2742  0:00:00 ETA
written to stdout
INFO: Trying to find the correct directory...
INFO: Found Home Assistant configuration directory at '/config'
INFO: Creating custom_components directory...
INFO: Changing to the custom_components directory...
INFO: Downloading HACS
Connecting to github.com (140.82.121.4:443)
Connecting to github.com (140.82.121.4:443)
Connecting to objects.githubusercontent.com (185.199.110.133:443)
saving to 'hacs.zip'
hacs.zip             100% |**************************************************************************************************************************************************************************************************| 1943k  0:00:00 ETA
'hacs.zip' saved
INFO: Creating HACS directory...
INFO: Unpacking HACS...
INFO: Removing HACS zip file...
INFO: Installation complete.

INFO: Remember to restart Home Assistant before you configure it

Como se indica en la última línea, se debe reiniciar el Home Assistant, en nuestro casos haremos un reinicio completo del contenedor, para ello, primero nos salimos del contenedor

bash-5.1# exit
exit
[~] # 

Realizamos el reinicio del contenedor de Home Assistant

[~] # docker restart home-assistant 
home-assistant 
[~] # 

Al igual que para entrar en la consola, si se tiene instalado Portainer se puede realizar el reinicio desde la página web, seleccionando del contenedor y pulsando en «Restart«

Configuración HACS en Home Assistant

Una vez realizados los pasos anteriores, con la instalación del scripts de HACS, procederemos a configurar HACS en el propio Home Assistant, consiste básicamente en realizar una instalación como de cualquier otra integración, para ello abriremos la páginas de instalación de las integraciones, pulsando el botón Ajustes -> Dispositivos y servicios

Una vez abierta la ventana pulsaremos el botón «Añadir integración«, botón señalado como número 3 en la siguiente imagen

Buscamos la integración con nombre HACS

Al finalizar nos mostrar una ventana sobre información que deberemos conocer, marcaremos las todas la opciones indicando que lo conocemos.

En el siguiente paso nos muestra la página con los pasos que deberemos hacer para darle acceso a nuestra cuenta de GitHub

Accederemos a la página indicada, si no estábamos con sesión iniciada en GitHub la iniciaremos, introduciremos el código que se indica y pulsaremos el botón «Continue«:

Nos mostrará la ventana de autorización y pulsaremos sobre el botón «Authorize hacs«

Terminaremos la instalación, seleccionando el área donde añadirlo, siendo opcional, y pulsando el botón Terminar

Una vez terminado, nos volverá a pedir reiniciar el Home Assistant, tras realizarlo podemos ver que nos sale un nuevo menú, con el cual se accede a la tienda HACS.