Home Assistant es una plataforma de código abierto para integrar, controlar y automatizar los dispositivos de una vivienda, con especial atención al control local y la privacidad.
En los artículos anteriores hemos analizado las diferentes arquitecturas de red, los ecosistemas comerciales y los protocolos de comunicación por radiofrecuencia. Ha llegado el momento de centralizar todo esto en un único punto. Necesitamos un cerebro, un servidor que actúe como director de orquesta.
En este curso será el punto común entre nuestros dispositivos, interfaces y automatizaciones. Antes de instalarlo conviene entender sus dos métodos compatibles actuales, porque la elección determina quién se encargará de mantener el sistema.
¿Qué es Home Assistant?
Home Assistant (frecuentemente abreviado como HA) es un software de automatización del hogar de código abierto (Open Source). Está escrito principalmente en Python y su objetivo fundamental es ser un sistema de control agnóstico e independiente del fabricante, priorizando siempre el control local y la privacidad.
Básicamente, Home Assistant actúa como un traductor universal y un motor de reglas.
Se encarga de conectarse a la API local de tu bombilla Shelly, al dongle USB de tu red Zigbee, y a la nube de tu termostato (si no queda más remedio), y normaliza todos esos datos en un formato estándar interno. Una vez que todos los dispositivos “hablan el mismo idioma” dentro de HA, podemos crear interfaces de control (Dashboards) y automatizaciones complejas que crucen información entre diferentes marcas sin ningún problema.
Métodos de instalación
Durante años, al entrar en la página oficial de Home Assistant te encontrabas con cuatro métodos de instalación diferentes. Hoy la situación es más sencilla: Home Assistant OS y Home Assistant Container son las dos vías compatibles, mientras que Core y Supervised dejaron de estar soportadas a partir de Home Assistant 2025.12.
Home Assistant no es un simple programa ejecutable (un .exe o un script). Es un ecosistema completo que puede desplegarse en diferentes capas. Vamos a analizar las dos vías recomendadas y las dos opciones heredadas que todavía conviene conocer para no liarnos leyendo tutoriales antiguos.
Home Assistant OS (HAOS)
Este es el método recomendado para el 90% de los usuarios, y el que vamos a utilizar como referencia principal en la mayoría de instalaciones dedicadas.
Home Assistant OS no es solo el programa de domótica. Es un sistema operativo completo, minimalista y optimizado (basado en Buildroot) diseñado con el único propósito de ejecutar Home Assistant en hardware dedicado (como una Raspberry Pi o un Mini PC).
La arquitectura interna de HAOS se divide en varias capas de contenedores:
- El Sistema Operativo base (HAOS).
- Docker, que corre de forma nativa sobre el OS.
- El Supervisor: Un contenedor especial cuya única función es monitorizar y gestionar al resto del sistema.
- El Core: El contenedor que ejecuta realmente el código en Python de Home Assistant.
- Las aplicaciones: Contenedores adicionales que el Supervisor instala y configura por nosotros (hasta hace poco se llamaban Add-ons o complementos).
El concepto de aplicación es importante. En HAOS, si necesitas instalar un broker MQTT como Mosquitto o el software Zigbee2MQTT, puedes hacerlo desde la interfaz. El Supervisor se encarga de descargar la imagen, configurar las redes internas y levantar el contenedor.
Home Assistant Container
Esta es la opción preferida por usuarios avanzados que ya disponen de un servidor Linux con contenedores, por ejemplo en un NAS o una máquina dedicada.
En este método desplegamos la imagen oficial ghcr.io/home-assistant/home-assistant:stable con Docker Compose u otro entorno OCI compatible.
- Ventaja: Tienes un control absoluto. Home Assistant es solo un contenedor más en tu ecosistema, compartiendo recursos con tu Plex, Nextcloud o Pi-hole.
- Inconveniente: No tienes Supervisor ni aplicaciones gestionadas por Home Assistant. Si quieres instalar un broker MQTT o Node-RED, tendrás que desplegar y actualizar por tu cuenta sus contenedores.
Si eres administrador de sistemas o desarrollador y dominas Docker, esta opción es extremadamente limpia y portátil. Si no quieres tocar una terminal de Linux, huye de este método y usa HAOS.
La gran diferencia práctica no es “Docker sí o Docker no”. La diferencia es quién se encarga de operar el ecosistema. En HAOS, Home Assistant gestiona el Supervisor, las aplicaciones, las actualizaciones y las copias desde la interfaz. En Container, esa responsabilidad pasa a ser vuestra.
Home Assistant Supervised (método heredado)
El método Supervised intentaba ser un híbrido entre los dos anteriores. Ya no está soportado, aunque conviene reconocer el nombre cuando aparezca en tutoriales antiguos.
Consiste en instalar un sistema operativo Debian puro (estricto y sin modificaciones), instalar Docker tú mismo, y luego ejecutar un script que inyecta el Supervisor en tu sistema. De esta forma, mantenías el control del sistema operativo y conservabas la tienda de aplicaciones en la interfaz de Home Assistant.
El problema de esta arquitectura es que el Supervisor es extremadamente exigente. Si instalas cualquier otro software en ese Debian que no le guste al Supervisor (o que cambie la configuración de red de Docker o de AppArmor), tu sistema marcará un error de “Unhealthy” o “Unsupported”, y el Supervisor se negará a actualizar Home Assistant hasta que lo arregles.
Home Assistant Core (método heredado)
Este fue el método original en los inicios del proyecto. Hoy queda principalmente como entorno para desarrollar Home Assistant e integraciones y ya no se ofrece como instalación compatible para usuarios finales.
Consiste en crear un entorno virtual de Python (venv) en una máquina Linux, macOS o Windows mediante WSL, e instalar el paquete homeassistant vía pip.
No hay Docker, Supervisor ni aplicaciones gestionadas, y tienes que mantener las versiones de Python, las dependencias del sistema y el arranque del proceso. No es la vía recomendada para una vivienda.
¿Qué método elegir para el curso?
Para seguir el resto de tutoriales de este curso y garantizar que nos centramos en la domótica y no en la administración de sistemas Linux, nuestra recomendación firme es utilizar Home Assistant OS (HAOS).
HAOS nos proporciona un entorno predecible y acceso al Supervisor, lo que facilita la instalación de aplicaciones como Zigbee2MQTT, ESPHome o Node-RED.
