Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.
Actualizado el 23 de julio de 2026
Si quieres llevar tu hogar inteligente al siguiente nivel, hay una herramienta de la que no puedes prescindir: HACS, o la Home Assistant Community Store. HACS es una especie de «App Store» abierta para tu servidor de domótica. Al ser un repositorio comunitario, cualquier desarrollador puede publicar sus aportaciones, lo que abre un abanico infinito de posibilidades.
Gracias a ella, he podido instalar desde tarjetas personalizadas para mis paneles hasta integraciones personalizadas complejas como el control de climatización Airzone o incluso monitorizar el precio de las gasolineras en España con HACS. En este tutorial definitivo te guiaré paso a paso para realizar una instalación limpia, segura y adaptada a los estándares actuales.
Compatibilidad y Requisitos según tu Instalación
Antes de ver cómo instalar HACS en Home Assistant, debes saber que el procedimiento varía notablemente según el método que hayas elegido para desplegar tu sistema. En 2026, la opción predilecta sigue siendo Home Assistant OS por su estabilidad y facilidad de uso, pero existen otros escenarios.
He preparado esta tabla comparativa para que identifiques rápidamente tu compatibilidad y el método que debes seguir:
| Tipo de Instalación | Compatibilidad HACS | Método de Acceso Requerido |
| Home Assistant OS (HAOS) | Totalmente Compatible | A través de la App de Terminal SSH |
| Home Assistant Supervised | Totalmente Compatible | A través de la App de Terminal SSH |
| Home Assistant Container (Docker) | Compatible | Ejecución de comandos dentro del contenedor |
| Home Assistant Core | Compatible (Avanzado) | Acceso CLI del usuario del sistema operativo |
Si aún no has dado el paso y quieres montar un servidor dedicado robusto, te recomiendo leer mi guía sobre cómo instalar Home Assistant en máquina Virtual Synology para disponer de un entorno HAOS completo.
Advertencia de Seguridad Importante
Al instalar elementos desde HACS, estás introduciendo código desarrollado por terceros directamente en el núcleo de tu hogar inteligente. A diferencia de las integraciones oficiales de Home Assistant, estos repositorios no pasan por el control estricto de Nabu Casa.
En mi experiencia, la comunidad es sumamente respetuosa y los problemas graves son casi inexistentes, pero la prudencia es obligatoria. Antes de añadir cualquier repositorio no verificado, lee las opiniones de otros usuarios y, sobre todo, asegúrate de hacer una copia de seguridad automática de Home Assistant en Google Drive para evitar sustos si alguna actualización rompe tu configuración.
Paso 1: Habilitar el Modo Avanzado y preparar la Terminal
Para llevar a cabo la instalación, utilizaremos una de las herramientas más potentes del sistema. En Home Assistant OS y entornos Supervised, podemos aprovechar el ecosistema de Apps (anteriormente conocidos como Add-ons) para interactuar con la línea de comandos de manera rápida y segura.
Lo primero que debes hacer es activar el Modo Avanzado en tu cuenta de usuario:
- Haz clic en tu nombre de perfil (abajo a la izquierda).
- Desplázate hacia abajo y activa la casilla «Modo avanzado». Si no haces esto, muchas opciones del sistema permanecerán ocultas.
A continuación, instalaremos la herramienta de acceso directo:
- Ve al menú lateral y entra en Ajustes > Apps (recuerda que antes conocíamos este apartado como Add-ons o Complementos).
- Entra en la Tienda de Apps (ubicada abajo a la derecha).
- Busca la App llamada «SSH & Web Terminal» (o en su defecto, «Terminal & SSH»).
- Haz clic en Instalar y, una vez finalizado el proceso, marca las casillas de «Mostrar en la barra lateral» e inicia la App.
Paso 2: Ejecutar el Script oficial de HACS
Ahora que disponemos de una línea de comandos, la instalación real de la tienda es sumamente sencilla. El equipo de HACS proporciona un script automatizado que se encarga de descargar la última versión compatible, ubicar los archivos en la ruta correcta (custom_components) y preparar el sistema.
Abre tu nueva App de Terminal desde el menú lateral y escribe o pega el siguiente comando:
wget -q -O - https://install.hacs.xyz | bash -Nota: Este comando es universal para instalaciones basadas en arquitecturas habituales (como Raspberry Pi, x86_64, etc.). Si usas un entorno Docker personalizado, recuerda que deberás acceder primero a la terminal de tu contenedor con docker exec -it homeassistant bash antes de lanzar la instrucción anterior.
Una vez que la pantalla de la terminal te confirme que el proceso ha finalizado con éxito, debes reiniciar por completo tu servidor de Home Assistant para que el sistema reconozca la nueva estructura de archivos de la tienda. Puedes hacerlo desde Ajustes > Sistema > Reiniciar.
Paso 3: Vinculación e Integración con GitHub
Una vez reiniciado el sistema, el último paso consiste en conectar HACS con la plataforma donde se alojan todos los recursos del ecosistema: GitHub. Necesitarás tener una cuenta gratuita de GitHub para poder descargar y actualizar tus componentes.
- Ve a Ajustes > Dispositivos y Servicios.
- Haz clic en «Añadir integración» en la esquina inferior derecha.
- Busca «HACS» en la lista y selecciónalo.
- Acepta las condiciones de seguridad obligatorias que se te muestran en pantalla (aquellas donde declaras entender que estás instalando código de la comunidad).
- A continuación, el sistema te mostrará una ventana con un código de 8 dígitos y un enlace para vincular tu cuenta con los repositorios de GitHub.
- Accede al enlace indicado (github.com/login/device), inicia sesión con tu cuenta y pega el código de verificación para autorizar la conexión.
¡Y listo! Al volver a tu panel de Home Assistant, verás que HACS se habrá añadido correctamente a tu menú lateral. El sistema iniciará una sincronización en segundo plano para construir el catálogo local de descargas, un proceso que suele tardar un par de minutos.
Práctica: Añade tu Primera Tarjeta Personalizada
Con HACS ya configurado, ha llegado el momento de sacarle partido. Uno de los mayores atractivos es modificar la apariencia del frontend. Para dar tus primeros pasos, te sugiero instalar un recurso de personalización imprescindible.
Por ejemplo, puedes utilizar HACS para instalar personalizacion con card-mod en Home Assistant, una herramienta espectacular que te permite añadir CSS a tus tarjetas, o incluso buscar nuevos temas en Home Assistant para dotar a tu salpicadero de un look oscuro o futurista.
El proceso para añadir cualquier elemento de la comunidad es siempre el mismo:
- Entra en el menú de HACS de tu barra lateral.
- Navega por las pestañas de «Integraciones» o «Frontend» (donde se encuentran las tarjetas Lovelace y temas).
- Usa el buscador integrado para localizar el proyecto que te interese.
- Haz clic en «Descargar» en la esquina inferior derecha y selecciona la última versión disponible.
- En el caso de tarjetas de interfaz o temas, el sistema te pedirá recargar los recursos del panel Lovelace para aplicarlos inmediatamente.
Resolución de Problemas Comunes (Troubleshooting)
Incluso en las mejores instalaciones, a veces surgen imprevistos. A continuación, te detallo las incidencias más frecuentes de la comunidad en 2026 y cómo resolverlas de manera eficiente:
1. HACS no aparece en la lista de integraciones tras reiniciar
Este es el fallo más habitual tras una instalación fresca. En la mayoría de ocasiones se debe a que el navegador web mantiene en memoria (caché) la versión anterior de la interfaz de Home Assistant.
Solución: Fuerza una recarga completa de la caché de tu navegador. Si estás en Windows, pulsa Ctrl + F5. En macOS, utiliza la combinación Cmd + Shift + R. También puedes probar a acceder desde una pestaña de incógnito o limpiar la caché de la aplicación móvil.
2. Límite de peticiones de la API de GitHub superado (API Rate Limit)
GitHub limita las llamadas que los usuarios no autenticados o con conexiones compartidas pueden hacer a sus servidores. Si intentas realizar búsquedas o descargar de manera masiva, HACS podría bloquearse temporalmente.
Solución: Asegúrate de que has completado el proceso de vinculación OAuth del Paso 3. Al asociar una cuenta personal de GitHub a tu integración de HACS, tu límite de peticiones pasa a ser de 5.000 consultas por hora, eliminando por completo este molesto problema. Si te ocurre durante la primera configuración, bastará con esperar una hora para que el contador de GitHub se restablezca automáticamente.
Continúa leyendo
Siguiente guía relacionada · 5 min de lectura
Recorder Home Assistant
La Recorder o grabadora, es la responsable de almacenar los detalles en una base de datos, que luego son manejados por la history integración. La recorder, guarda…
Continuar con este artículo