Instalar home assistant docker en tu NAS o mini PC parece la vía rápida, pero pronto descubres que la tienda de add-ons no existe y las copias de seguridad son cosa tuya. Si no tienes claro si te conviene el contenedor o el sistema operativo completo, estás en el sitio adecuado.
Te cuento lo que me ha funcionado en mi propia casa y los errores que he evitado. Vamos a ver si el container es tu opción o si deberías ir a por Home Assistant OS, sin rodeos y con datos reales de consumo y gestión.
Qué es exactamente Home Assistant en Docker (y qué no es)
Cuando hablas de home assistant docker, no estás instalando el sistema completo. Estás ejecutando únicamente el núcleo de Home Assistant, el motor que interpreta tus automatizaciones y controla tus dispositivos, dentro de un contenedor aislado. No incluye sistema operativo propio ni interfaz de gestión adicional. Es, literalmente, la aplicación en sí.
Home Assistant OS, en cambio, es una distribución Linux empaquetada que añade una capa de gestión por encima. Ahí vive el Supervisor, que es quien se encarga de gestionar actualizaciones con rollback automático, crear copias de seguridad con un clic y ofrecer la tienda de add-ons como contenedores listos para usar. Si instalas el Container, esa capa no existe. Tú eres el Supervisor.
Esto genera mucha confusión porque, hasta hace poco, existían métodos como “Core” o “Supervised” que intentaban cubrir huecos intermedios. Hoy en día, esos métodos ya no se ofrecen oficialmente. La comunidad y el equipo de desarrollo han simplificado las opciones: o vas a por el OS completo, que es la vía recomendada para la inmensa mayoría, o te metes de lleno en el mundo Docker con el Container.
En mi casa, empecé con el OS porque quería tranquilidad. No quería estar pensando en si mi base de datos SQLite se había corrompido o si una actualización me había dejado sin acceso. El OS me quitó esa carga. Pero cuando pasé a gestionar mis propios contenedores en un NAS, entendí la lógica del Container: menos capas, menos dependencias y más control directo sobre lo que corre.
No es que uno sea mejor que otro por defecto. Son herramientas distintas para perfiles distintos. El OS te da la mano; el Docker te deja solo con las herramientas. Si ya sabes usar Docker, el Container te resulta lógico. Si no, el OS te va a ahorrar dolores de cabeza que no te van a compensar.
Qué pierdes al elegir Home Assistant Container
Al instalar Home Assistant en Docker, te olvidas de la tienda de add-ons. No existe. Si en el OS instalabas Mosquitto o Node-RED con un clic desde la interfaz web, aquí tienes que montar cada servicio manualmente como un contenedor aparte. Es más trabajo, pero te da control total.
La gestión de actualizaciones y copias de seguridad deja de ser automática. En el sistema operativo, el Supervisor te avisa, actualiza y tiene un rollback si algo falla. En el Container, si una actualización rompe algo, no hay botón mágico. Tú tienes que hacer el backup de la carpeta de configuración antes de tocar nada. Si no lo haces, estás a merced de la suerte.
También desaparece la integración profunda de ciertas apps en la interfaz. El Supervisor inyecta información del sistema (estado del disco, red, versión de cada add-on) directamente en el panel de Home Assistant. En Docker, esa capa de comunicación no existe. Tendrás que confiar en que el contenedor está sano sin que la interfaz te lo confirme visualmente de la misma forma.
El caso ESPHome: el add-on que muchos echarán de menos
ESPHome es el ejemplo más claro. En el OS, el add-on de ESPHome te permite compilar firmware, flashear dispositivos y ver el log en tiempo real desde la web. En Docker, eso no está. Tendrás que instalar el contenedor de ESPHome por separado y configurarlo para que hable con tu Home Assistant.
No es imposible, pero es un paso extra que si no estás acostumbrado a Docker, te puede frenar. La comunidad confirma que casi todos los add-ons tienen un equivalente en contenedor, pero el flujo de trabajo cambia. Ya no es “instalar y usar”, es “configurar y orquestar”.
Si planeas usar muchas apps de terceros o quieres que todo se gestione desde un solo panel, el OS sigue siendo más cómodo. Pero si ya tienes un NAS o un mini PC donde gestionas tus propios servicios, esta pérdida de “magia” se compensa con la coherencia de tener todo bajo un mismo sistema de contenedores.
Qué ganas si ya tienes un NAS o mini PC con Docker
Si ya gestionas un NAS o un mini PC como servidor central, Home Assistant Container encaja de maravilla. No tienes que instalar un sistema operativo completo solo para que funcione un panel de control. Un contenedor Docker consume muy pocos recursos en comparación con Home Assistant OS.
En mi caso, corriendo sobre un mini PC con un procesador Intel N100, la diferencia es notable. El sistema operativo anfitrión (Linux o Windows) ya está corriendo, y Home Assistant solo ocupa la RAM y la CPU que necesita para procesar entidades. No estás pagando en consumo eléctrico por una capa de virtualización completa que no utilizas.
La ventaja principal es la coherencia. Si ya tienes tu red doméstica, tus respaldos y tus servicios gestionados mediante Docker Compose, añadir Home Assistant es solo una línea más en tu archivo. Todo tu stack vive en un solo lugar. Si necesitas actualizar el sistema operativo o reconfigurar la red, lo haces en el anfitrión, no peleando con la interfaz de Supervisor.
Tienes libertad total sobre el sistema operativo. Puedes usar la distribución Linux que prefieras, configurar permisos a tu gusto y decidir exactamente qué recursos asignas al contenedor. No dependes de que el equipo de Home Assistant compile una imagen para tu hardware específico.
Esta flexibilidad es clave si planeas integrar otros servicios. Por ejemplo, si quieres monitorizar el consumo de tus dispositivos o gestionar la red de forma avanzada, puedes montar contenedores adicionales que hablen directamente con Home Assistant sin las limitaciones del entorno aislado de HAOS. Es una solución más “limpia” para quien entiende de infraestructura.
Docker-compose de Home Assistant listo para copiar
Si decides ir por el camino del contenedor, necesitas un archivo docker-compose.yml que funcione desde el primer minuto. La imagen oficial es ghcr.io/home-assistant/home-assistant:stable. No uses tags desactualizadas; la comunidad actualiza la rama stable con regularidad.
Aquí tienes la base mínima que he usado en mi NAS. Fíjate en los detalles:
services:
homeassistant:
container_name: homeassistant
image: ghcr.io/home-assistant/home-assistant:stable
privileged: true
network_mode: host
restart: unless-stopped
environment:
- TZ=Europe/Madrid
volumes:
- ./config:/config
- /run/dbus:/run/dbus:ro
- /etc/localtime:/etc/localtime:ro
stop_grace_period: 60sEl parámetro network_mode: host es crítico. Sin él, el descubrimiento de dispositivos Zigbee o Matter no funcionará bien porque el contenedor queda aislado en una red virtual. Al usar la red del host, Home Assistant escucha los puertos directamente en tu interfaz física.
privileged: true es necesario para acceder a los puertos serie de los adaptadores Zigbee. Es una concesión de seguridad, pero en un NAS doméstico es el estándar de facto.
No olvides el stop_grace_period: 60s. El timeout por defecto de Docker es de 10 segundos, insuficiente para que Home Assistant cierre limpiamente su base de datos SQLite. Si cortas la energía o reinicias el NAS sin este ajuste, podrías corromper la base de datos y perder historial.
Para la zona horaria, usa TZ=Europe/Madrid. Es la variable de entorno estándar en contenedores Linux.
Cómo actualizar y restaurar sin Supervisor
Aquí es donde el modelo cambia. En HAOS, pulsas un botón y el Supervisor gestiona el rollback si algo falla. En Docker, tú eres el Supervisor.
Para actualizar, simplemente ejecuta docker compose pull y luego docker compose up -d. La imagen nueva se descarga y el contenedor se reinicia con la nueva versión. No hay interfaz gráfica para ello.
Las copias de seguridad son tu responsabilidad. Lo habitual es hacer un tar de la carpeta ./config donde montas el volumen. Si quieres automatizarlo, crea un script en tu NAS que copie esa carpeta a un almacenamiento externo o a la nube.
Si quieres centralizar las notificaciones y la integración con Alexa, añade Mosquitto MQTT como servicio extra en el mismo compose. Es un broker ligero que consume casi nada y te permite que otros contenedores se comuniquen con Home Assistant sin depender de la API REST.
Cómo sustituir los add-ons con contenedores equivalentes
La objeción más común es que sin el Supervisor no tienes tienda de add-ons. La realidad es que casi todos tienen un contenedor Docker independiente equivalente. No necesitas el ecosistema cerrado para tener funcionalidad completa; solo necesitas saber lanzar la imagen correcta.
En mi caso, el triángulo que más uso son Mosquitto, Zigbee2MQTT y Node-RED. Mosquitto es un broker MQTT ligero que ya mencioné antes para la comunicación interna. Zigbee2MQTT es la forma estándar de gestionar tu red Zigbee sin depender de un add-on. Y Node-RED te da esa lógica visual de nodos que tanto gusta a la comunidad. Todos tienen imágenes oficiales en Docker Hub o en el registro de Home Assistant.
Lo que sí cambia es la gestión. En HAOS, instalas el add-on y listo. En Docker, añades un bloque nuevo en tu docker-compose.yml con la imagen correspondiente. Es un paso extra, pero te da un control total sobre la versión y los recursos asignados.
Un punto crítico es el acceso USB. Si quieres flashear un dispositivo Zigbee o Matter directamente al contenedor, no basta con montarlo. Debes pasar el dispositivo al contenedor usando el parámetro devices en la configuración. Por ejemplo, si tu adaptador Zigbee está en /dev/ttyUSB0, lo declaras explícitamente. Sin esto, el contenedor no lo ve.
No es un proceso idéntico al de los add-ons, pero la curva de aprendizaje es baja si ya manejas Docker. La comunidad tiene documentación clara para cada servicio. No pierdes funciones, solo cambias el método de empaquetado.
¿Y si no tienes Docker? Alternativa sin complicaciones
Si la idea de gestionar contenedores, redes y permisos te da pereza, Home Assistant OS es la vía directa. La opción más sencilla es el Home Assistant Green. Es una caja cerrada con HAOS preinstalado de fábrica. Lo enchufas, conectas el USB y en menos de diez minutos tienes el onboarding completado. No tocas ni una línea de código. Su consumo en reposo es de solo 1,7 W, algo irrelevante con las tarifas eléctricas actuales en España. El único pero es su memoria eMMC de 32 GB, que puede quedarse corta si guardas muchas grabaciones o logs.
Si prefieres más potencia, un mini PC como el Beelink N100 es una alternativa sólida. Puedes instalar HAOS en modo bare-metal directamente sobre su disco NVMe. Obtienes 16 GB de RAM y 500 GB de almacenamiento, suficiente para mover cientos de entidades y grabaciones sin sudar. El consumo sube a unos 7-9 W, pero sigues por debajo de un ordenador de sobremesa antiguo. Si te atreves un poco más, Proxmox permite montar HAOS como máquina virtual, dándote la flexibilidad de crear otros sistemas operativos en el mismo hardware. Sin embargo, para el usuario medio, el Green o el mini PC en modo nativo resuelven el problema sin la complejidad de orquestar contenedores.
Mi recomendación: ¿merece la pena Home Assistant en Docker?
La respuesta corta es: depende de tu nivel de compromiso técnico. Si ya gestionas un NAS o un mini PC con Docker y te resultan naturales los contenedores, el Home Assistant Container es una opción perfectamente viable. Aprovechas la infraestructura que ya tienes y, como hemos visto, el consumo de recursos es menor que el de una instalación completa en HAOS. Además, tienes el control total sobre el ciclo de vida de la aplicación.
Por el contrario, si tu prioridad es que el sistema funcione sin que tengas que pensar en él, olvídate de Docker. El método recomendado por la propia comunidad es Home Assistant OS. Aquí el Supervisor gestiona las actualizaciones con rollback automático, crea copias de seguridad y ofrece la tienda de add-ons sin que tengas que mapear volúmenes manualmente. Si te asusta la idea de restaurar tu sistema tras un fallo sin un solo clic, esta es tu vía.
Para quienes dudan entre ambas opciones, instalar HAOS en una máquina virtual (como Proxmox) o en un mini PC dedicado es el punto medio ideal. Obtienes la robustez del sistema operativo completo sin la sobrecarga de orquestar servicios adicionales. Si no quieres complicaciones, echa un vistazo a el precio del Home Assistant Green en España, que resuelve el 90% de los casos domésticos sin tocar una terminal.
En mi caso, tras años probando ambos métodos, el Container me funciona cuando necesito integración profunda con otros servicios de mi red, pero para el usuario medio, la simplicidad de HAOS gana por goleada. No dejes la decisión para mañana: copia el docker-compose que te he dejado arriba y decide hoy qué método de instalación encaja mejor con tu estilo.
Si estás montando esto desde cero, te interesa leer también qué incluye Home Assistant Cloud y si merece la pena Matter en 2026.
Preguntas frecuentes
¿Puedo instalar add-ons en Home Assistant Container?
No. Los add-ons necesitan Supervisor, exclusivo de Home Assistant OS. La alternativa es correr contenedores independientes equivalentes que gestionas tú.
¿Cómo hago copias de seguridad en Home Assistant Docker?
Sin Supervisor no hay restauración con un clic: debes copiar la carpeta de configuración con tu propio sistema, por ejemplo scripts o la función de backup del NAS.
¿Home Assistant en Docker consume muchos recursos?
Al contrario: según la comunidad, un contenedor necesita muy pocos recursos comparado con HAOS completo, ideal para compartir máquina con otros servicios.
¿Puedo pasar un stick Zigbee USB al contenedor?
Sí, mapeando el dispositivo USB en el compose, pero depende del entorno Docker del host; algunos NAS no permiten redirigir puertos USB físicos.
Precios actualizados a octubre de 2026. Pueden variar. Este artículo contiene enlaces de afiliado: si compras a través de ellos, nos ayudas a mantener el blog sin coste adicional para ti.