Actualizar Home Assistant: Guía Paso a Paso [2026]

Actualizado el 25 de enero de 2026

Mantener tu instalación de Home Assistant al día es fundamental. Cada actualización no solo trae nuevas y emocionantes funcionalidades, sino que también incluye parches de seguridad cruciales y mejoras de rendimiento. Afortunadamente, en 2026 el proceso para actualizar Home Assistant es más sencillo y seguro que nunca, especialmente si utilizas Home Assistant OS, el método de instalación más popular.

Antes de Actualizar: El Paso Más Importante (Backup Home Assistant)

Antes de pulsar cualquier botón de actualización, hay una regla de oro que siempre sigo y que tú también deberías: crear una copia de seguridad completa. En el ecosistema de Home Assistant, esto se conoce como «Snapshot». Una copia de seguridad es tu red de seguridad; si algo sale mal, puedes restaurar tu sistema exactamente al estado en que estaba en cuestión de minutos.

Crear un backup en Home Assistant es un proceso muy simple desde la interfaz de usuario:

Navega a Ajustes > Sistema > Copias de seguridad.
Haz clic en el botón azul «+ CREAR COPIA DE SEGURIDAD» en la esquina inferior derecha.
Se abrirá un diálogo. Puedes darle un nombre específico, pero lo más importante es asegurarte de que sea una Copia de seguridad completa.
Pulsa «Crear«. El proceso tardará unos minutos dependiendo del tamaño de tu instalación.
Una vez creada, haz clic sobre ella y selecciona «Descargar copia de seguridad«. Guárdala en un lugar seguro fuera del dispositivo donde se ejecuta Home Assistant (tu ordenador, un NAS, etc.).

Para una tranquilidad total, te recomiendo automatizar este proceso. Puedes aprender a hacerlo en mi guía para integrar Google Drive con Home Assistant y tener tus copias siempre a salvo en la nube.

Cómo Actualizar Home Assistant OS (Método para el 99% de Usuarios)

Si instalaste Home Assistant usando la imagen oficial para Raspberry Pi, ODROID, un NUC o como una máquina virtual, estás usando Home Assistant OS. Para ti, el proceso de actualización es tan simple como hacer clic en un botón.

Paso 1: Localiza la notificación de actualización
Cuando haya una nueva versión disponible, Home Assistant te lo notificará. Verás un indicador en el menú de Ajustes. Al entrar, dirígete a Sistema > Actualizaciones. Allí verás «Home Assistant Core» con la nueva versión lista para instalar.

Paso 2: Revisa los «Breaking Changes»
Justo debajo del nombre de la actualización, verás un enlace a las «Notas de la versión». ¡No lo ignores! Haz clic y busca la sección «Breaking Changes» (Cambios Importantes). Lee atentamente si alguno de los cambios afecta a las integraciones o componentes que utilizas. Este simple gesto te puede ahorrar muchos dolores de cabeza.

Paso 3: Instala la actualización
Si después de revisar los cambios importantes todo parece correcto, simplemente pulsa el botón «INSTALAR«. Home Assistant se encargará de todo: descargará la nueva versión, la instalará y se reiniciará automáticamente. El proceso puede durar entre 5 y 15 minutos. ¡Ten paciencia y no desconectes el dispositivo!

El Ecosistema: Actualizar Add-ons y HACS

Tu sistema Home Assistant es más que solo el «Core». Los Add-ons (complementos) y las integraciones de la comunidad a través de HACS también necesitan atención.

Actualizar Add-ons

Los Add-ons como Mosquitto Broker, Zigbee2MQTT o AdGuard Home se actualizan por separado. Puedes ver si hay actualizaciones pendientes en Ajustes > Complementos. Mi recomendación es mantenerlos siempre al día, especialmente después de una actualización del Core.

Cómo Actualizar HACS

HACS (Home Assistant Community Store) es la puerta de entrada a increíbles personalizaciones, pero tanto HACS como sus componentes se gestionan de forma independiente.

Actualizar HACS: Si HACS tiene una actualización, te lo indicará en su propia sección en la barra lateral. El proceso es similar: un clic para actualizar.
Actualizar Integraciones de HACS: Dentro del panel de HACS, ve a «Integraciones». Verás una lista de todo lo que has instalado y un aviso si alguno tiene una nueva versión pendiente.

Guía de Actualización por Tipo de Instalación (2026)

Aunque la mayoría usa Home Assistant OS, existen otros métodos de instalación para usuarios más avanzados. La forma de actualizar varía significativamente entre ellos. Aquí tienes una tabla resumen para que identifiques tu caso:

Tipo de Instalación	Método de Actualización Principal	Nivel de Dificultad
Home Assistant OS	Botón en la Interfaz Gráfica (UI) desde Ajustes > Sistema > Actualizaciones.	Fácil
Home Assistant Container (Docker)	Descargar la nueva imagen y recrear el contenedor usando comandos CLI.	Medio
Home Assistant Core (en venv de Python)	Ejecutar un comando `pip install` en el terminal del sistema operativo.	Avanzado

Comandos de Actualización para Home Assistant (CLI)

Si tu instalación es de tipo Container o Core, la actualización se realiza mediante la línea de comandos (CLI). Estos son los comandos de actualización de Home Assistant CLI que necesitas. Recuerda ejecutar estos comandos como el usuario con el que instalaste Home Assistant para evitar problemas de permisos.

Actualizar Home Assistant Container (Docker)

Primero, detén y elimina tu contenedor actual. Luego, descarga la última imagen estable y vuelve a crear el contenedor con tu configuración original (volúmenes, puertos, etc.).

# Descargar la última imagen estable
docker pull homeassistant/home-assistant:stable

# (Aquí deberías parar y eliminar tu contenedor antiguo)
# docker stop homeassistant
# docker rm homeassistant

# (Y luego volver a crearlo con tu comando 'docker run' habitual)

Actualizar Home Assistant Core (Entorno Virtual)

Asegúrate de activar primero tu entorno virtual de Python.

# Actualizar a la última versión estable
pip3 install --upgrade homeassistant

También puedes instalar versiones específicas, aunque esto solo se recomienda para situaciones concretas o para probar funcionalidades.

# Instalar una versión específica (ej: 2026.1.5)
pip3 install homeassistant==2026.1.5

# Instalar la última versión beta (inestable)
pip3 install --pre --upgrade homeassistant

# Instalar la versión de desarrollo (muy inestable, no recomendado para producción)
pip3 install --upgrade git+git://github.com/home-assistant/home-assistant.git@dev

¿Algo Salió Mal? Cómo Volver a una Versión Anterior

Si tras la actualización algo no funciona como esperabas, que no cunda el pánico. La forma más segura y recomendada de volver atrás es restaurar la copia de seguridad que creaste al principio. Es un proceso fiable que te devolverá a un estado funcional conocido.

Si eres un usuario avanzado y quieres intentar un método manual, he documentado todo el proceso, incluyendo los errores que cometí y cómo los solucioné, en mi guía completa sobre cómo hacer un downgrade en Home Assistant.