Cómo Instalar Home Assistant en Unraid con Docker (Guía 2026)

¿Cansado de que tu casa sea 'inteligente' pero tus dispositivos no se entiendan entre sí? Home Assistant es la solución definitiva para unificarlo todo, y si ya tienes un servidor Unraid, estás a un paso de la domótica perfecta. Instalar Home Assistant en Unraid con Docker no solo es eficiente, sino que aprovecha al máximo la versatilidad de tu NAS, manteniéndolo todo organizado y fácil de gestionar. Olvídate de hardware adicional o sistemas operativos complejos; con Docker en Unraid, tendrás tu centro de control domótico funcionando en minutos.

Unraid, con su robusto sistema de paridad y su increíble facilidad para gestionar contenedores Docker, se ha consolidado como la plataforma preferida para los entusiastas del autoalojamiento. Si aún no estás familiarizado con Docker en Unraid, te recomiendo echarle un vistazo para entender el potencial de esta combinación. Es la base que nos permite ejecutar aplicaciones como Home Assistant de forma aislada y segura, sin interferir con el resto de tus servicios.

En esta guía de 2026, te mostraré paso a paso cómo instalar Home Assistant en Unraid utilizando Docker. Verás que es un proceso sencillo que no requiere conocimientos avanzados, y pronto estarás disfrutando de un hogar conectado como nunca. Además, la flexibilidad de Unraid te permitirá añadir otros servicios como Plex o Nextcloud sin complicaciones, consolidando tu servidor casero como el cerebro de tu vida digital. ¡Vamos a ello!

1. Preparativos antes de la instalación de Home Assistant en Unraid

Antes de lanzarnos a la instalación de Home Assistant, hay unos cuantos pasos previos que debemos asegurar en nuestro servidor Unraid. Son sencillos, pero cruciales para que todo funcione como es debido.

1.1. Asegúrate de tener Docker habilitado en Unraid

Esto puede parecer obvio, pero es el primer punto de control. Ve a la interfaz web de Unraid, navega a la pestaña 'Settings' y luego a 'Docker'. Asegúrate de que el 'Docker Service' esté habilitado. Si no lo está, actívalo y aplica los cambios. Unraid reiniciará el servicio de Docker, lo cual es normal.

1.2. Instala el plugin 'Community Applications' (CA)

Si aún no lo tienes, el plugin 'Community Applications' es prácticamente un 'must-have' en Unraid. Simplifica enormemente la instalación de aplicaciones Docker, como Home Assistant, al ofrecer plantillas preconfiguradas. Para instalarlo, ve a la pestaña 'Plugins', luego 'Install Plugin', y pega la URL de instalación (puedes encontrarla fácilmente buscando 'Unraid Community Applications GitHub' o en la documentación oficial de Unraid). Una vez instalado, verás una nueva pestaña llamada 'Apps'.

1.3. Crea una carpeta compartida para 'Appdata'

Aunque Unraid ya crea una compartición 'appdata' por defecto, es vital entender su función. Aquí es donde Home Assistant (y el resto de tus contenedores Docker) guardará su configuración, bases de datos y otros datos persistentes. Es crucial que esta carpeta esté en un disco protegido por paridad y preferiblemente en un SSD para un mejor rendimiento. Asegúrate de que la compartición 'appdata' tiene el 'Cache Pool' configurado en 'Prefer' o 'Only' si tienes un SSD para caché, esto mejorará mucho la velocidad de acceso a la configuración de Home Assistant.

1.4. Anota la IP de tu servidor Unraid

Necesitarás la dirección IP de tu servidor Unraid para acceder a la interfaz web de Home Assistant una vez instalado. Puedes encontrarla en la parte superior de la interfaz web de Unraid o en la configuración de red. Es recomendable que tu servidor Unraid tenga una IP estática en tu router para evitar problemas futuros.

2. Instalando Home Assistant desde 'Apps' en Unraid

Con los preparativos listos, la instalación de Home Assistant es sorprendentemente sencilla gracias a Community Applications. Sigue estos pasos:

2.1. Navega a la pestaña 'Apps' y busca Home Assistant

En la interfaz web de Unraid, haz clic en la pestaña 'Apps'. En la barra de búsqueda que verás arriba, escribe 'Home Assistant'. Te aparecerán varias opciones. Busca la que sea la imagen oficial o una plantilla bien mantenida. Generalmente, la que pone 'Home Assistant' a secas y tiene muchas descargas es la correcta.

2.2. Haz clic en 'Install' y configura la plantilla

Una vez que encuentres la plantilla de Home Assistant, haz clic en el botón 'Install' (Instalar). Se abrirá una ventana con la configuración de la plantilla Docker. No te asustes, la mayoría de los campos ya estarán preestablecidos, pero hay algunos que debemos revisar:

• Name: Puedes dejar 'HomeAssistant' o cambiarlo a algo más descriptivo, como 'DomoticaHA'.
• Repository: Debería ser algo como homeassistant/home-assistant. Esto indica la imagen Docker que se descargará.
• Network Type: Para la mayoría de los usuarios, 'Host' es la mejor opción. Esto permite que Home Assistant acceda directamente a tu red local y detecte dispositivos de forma más eficiente. Si eliges 'Bridge', tendrás que mapear puertos manualmente.
• WebUI Port: El puerto por defecto para Home Assistant es el 8123. Asegúrate de que este puerto no esté en uso por otra aplicación en tu Unraid. Si lo está, puedes cambiarlo aquí a otro disponible (ej: 8124).
• Path: /config (Appdata) Aquí es donde Home Assistant guardará todos sus datos. Debería apuntar a una subcarpeta dentro de tu compartición 'appdata', por ejemplo, /mnt/user/appdata/homeassistant. Asegúrate de que esta ruta sea correcta.
• PUID y PGID: Estos son el User ID (PUID) y Group ID (PGID) del usuario que ejecutará el contenedor. Es fundamental configurarlos correctamente para evitar problemas de permisos. Generalmente, puedes usar '99' para PUID y '100' para PGID, que corresponden al usuario 'nobody' y al grupo 'users' en Unraid. Si quieres usar un usuario específico, puedes encontrar su PUID/PGID en 'Users' en la interfaz de Unraid.

Una vez revisados y ajustados estos parámetros, haz clic en 'Apply' (Aplicar). Unraid descargará la imagen de Docker de Home Assistant y creará el contenedor. Este proceso puede tardar unos minutos dependiendo de tu conexión a internet.

3. Configuración inicial de Home Assistant

¡Enhorabuena! Si todo ha ido bien, Home Assistant ya está instalado y funcionando en tu servidor Unraid. Ahora toca acceder a su interfaz y empezar a configurarlo.

3.1. Accede a la interfaz web de Home Assistant

Abre tu navegador web y escribe la dirección IP de tu servidor Unraid seguida del puerto que configuraste (por defecto, 8123). Por ejemplo: http://192.168.1.100:8123. Si todo está correcto, deberías ver la pantalla de bienvenida de Home Assistant.

3.2. Crea tu cuenta de administrador

La primera vez que accedas, Home Assistant te pedirá que crees una cuenta de administrador. Introduce un nombre, un nombre de usuario y una contraseña segura. Estos serán tus credenciales para acceder a Home Assistant a partir de ahora.

3.3. Configuración inicial y detección de dispositivos

Después de crear tu cuenta, Home Assistant te guiará a través de una configuración inicial donde podrás:

• Ponerle un nombre a tu instalación.
• Seleccionar tu ubicación y zona horaria (importante para la automatización basada en el tiempo y el amanecer/atardecer).
• Elegir tu unidad de medida preferida (Celsius/Fahrenheit, metros/pies).

Una vez completado esto, Home Assistant empezará a escanear tu red en busca de dispositivos inteligentes compatibles. En la sección 'Integraciones' o en la pantalla principal de 'Visión General', verás sugerencias de dispositivos que ha detectado. Haz clic en 'Configurar' para integrarlos en tu sistema. Esto podría incluir bombillas inteligentes, termostatos, enchufes y otros dispositivos Zigbee, Z-Wave o Wi-Fi compatibles.

3.4. Explora la interfaz

Dedica un tiempo a explorar la interfaz de Home Assistant. Verás paneles para 'Visión General', 'Registros', 'Mapas', 'Historial', 'Desarrollador', y la sección clave: 'Ajustes'. Aquí es donde podrás gestionar tus integraciones, automatizaciones, scripts, escenas, y mucho más. La comunidad de Home Assistant es enorme, y hay infinidad de recursos y tutoriales para empezar a domotizar tu hogar.

4. Consejos avanzados y mantenimiento de Home Assistant en Unraid

Una vez que tienes Home Assistant funcionando, hay algunas prácticas recomendadas para asegurar su buen funcionamiento a largo plazo y sacarle el máximo partido.

4.1. Realiza copias de seguridad regularmente

Las copias de seguridad (backups) son vitales. La carpeta /mnt/user/appdata/homeassistant contiene toda tu configuración. Puedes hacer copias de seguridad de esta carpeta de varias maneras:

• Manual: Copia la carpeta a otra ubicación en tu array de Unraid o a un disco externo.
• Automática con GoodSync: Puedes usar una herramienta como GoodSync para sincronizar automáticamente tu carpeta de configuración de Home Assistant con tu PC o con un servicio en la nube.
• Add-ons de Home Assistant: Si has instalado Home Assistant OS (lo cual no es este caso, pero se menciona para contextualizar), hay add-ons de backup como 'Google Drive Backup'. En nuestro caso, al ser un contenedor Docker, el backup de la carpeta de configuración es la forma más directa.

4.2. Actualizando Home Assistant

Mantener Home Assistant actualizado es importante para acceder a nuevas funciones y mejoras de seguridad. Para actualizar tu contenedor Docker de Home Assistant en Unraid:

1. Ve a la pestaña 'Docker' en tu interfaz de Unraid.
2. Localiza el contenedor de Home Assistant.
3. Haz clic en el icono para 'Check for Updates' (generalmente un cuadrado con una flecha hacia arriba).
4. Si hay una actualización disponible, haz clic en el icono para 'Update' (también una flecha hacia arriba, a veces diferente).
5. Unraid descargará la nueva imagen y reiniciará el contenedor. Tu configuración se mantendrá intacta porque está en la carpeta /appdata.

4.3. Acceso a la configuración avanzada

Si necesitas editar archivos de configuración YAML manualmente (algo común para automatizaciones avanzadas o integraciones específicas), puedes acceder a la carpeta de configuración de Home Assistant directamente desde las comparticiones de Unraid. Simplemente navega a /mnt/user/appdata/homeassistant en tu explorador de archivos o a través de una conexión SMB/NFS y edita los archivos con tu editor de texto preferido.

4.4. Integración con otros servicios de Unraid

Una de las grandes ventajas de tener Home Assistant en Unraid es la sinergia con otros servicios. Por ejemplo, podrías tener una automatización que apague tu servidor Plex o Jellyfin cuando no se detecta actividad, o que controle la iluminación de tu homelab. La integración es casi ilimitada.

5. ¿Por qué Unraid es la plataforma ideal para Home Assistant?

A estas alturas, quizá te preguntes si Unraid es realmente la mejor opción para Home Assistant frente a otras alternativas como una Raspberry Pi. La respuesta es un rotundo sí, especialmente si ya posees o planeas montar un servidor casero con Unraid.

5.1. Centralización y eficiencia de recursos

Unraid te permite ejecutar Home Assistant junto con docenas de otros servicios Docker (servidor de medios como Jellyfin, nube personal con Nextcloud, servidores de juegos, etc.) en una única máquina. Esto es mucho más eficiente en términos de energía y espacio que tener múltiples dispositivos. Tu Unraid ya está encendido 24/7, ¿por qué no aprovecharlo?

5.2. Gestión de Docker simplificada

La interfaz de Unraid, combinada con Community Applications, hace que la gestión de contenedores Docker sea trivial. Iniciar, detener, actualizar o reconfigurar Home Assistant es cuestión de unos pocos clics, sin necesidad de comandos complejos en la terminal. Esto es una ventaja brutal frente a la gestión manual de Docker en sistemas operativos como Debian o Ubuntu.

5.3. Redundancia de datos y seguridad

Unraid protege tus datos con paridad. Esto significa que si uno de tus discos duros falla (donde reside tu configuración de Home Assistant), tus datos están seguros y pueden ser reconstruidos. Esta tranquilidad no la ofrecen la mayoría de soluciones 'plug and play' o una simple Raspberry Pi, donde una tarjeta SD corrupta puede significar perder toda tu configuración domótica.

5.4. Flexibilidad y escalabilidad

A medida que tus necesidades de homelab crecen, Unraid crece contigo. Puedes añadir más almacenamiento, más memoria RAM o un procesador más potente sin tener que reinstalar todo. Home Assistant, al ser un contenedor Docker, se beneficia directamente de estos recursos adicionales, permitiéndote integrar más dispositivos y automatizaciones sin preocuparte por el rendimiento.

Preguntas frecuentes

Veredicto

Unraid es, sin duda, una de las mejores plataformas para alojar Home Assistant, especialmente si ya eres usuario o estás pensando en montar un servidor casero robusto. La combinación de Docker, la facilidad de gestión de Community Applications y la seguridad de los datos que ofrece Unraid lo convierten en una opción estelar para la domótica.

Para quién sí es Unraid para Home Assistant: Si buscas una solución todo en uno para tu homelab, quieres centralizar tus servicios (media center, nube personal, domótica) y valoras la redundancia de datos. Si eres un entusiasta del autoalojamiento y no te importa invertir en una licencia que te durará toda la vida (o la de tu servidor), Unraid es tu mejor aliado. La curva de aprendizaje es razonable y la comunidad es enorme.

Para quién no es Unraid para Home Assistant: Si solo quieres Home Assistant y no tienes planes de añadir más servicios, o si tu presupuesto es extremadamente limitado y prefieres soluciones gratuitas como un Raspberry Pi con Home Assistant OS. Tampoco es la opción si buscas una experiencia 'plug and play' sin tocar configuraciones. Unraid es una inversión que merece la pena si vas a exprimir todas sus funcionalidades, no solo una.