
Actualizado el 15 de febrero de 2026
Saber cómo apagar Home Assistant de forma segura es una de las tareas de mantenimiento más críticas y, a menudo, subestimadas. Aunque pueda parecer tan simple como pulsar un botón, un apagado incorrecto, especialmente en sistemas como una Raspberry Pi, puede llevar a la corrupción de la base de datos o incluso dañar la tarjeta SD. Desde que la interfaz de Home Assistant se rediseñó hace años, la ubicación y los métodos han evolucionado. Esta guía definitiva de 2026 te mostrará todas las formas correctas de detener y apagar tu sistema, garantizando la integridad de tu hogar inteligente.
Diferencias Clave: Apagar el Host vs. Detener el Core
Antes de sumergirnos en los métodos, es fundamental entender las dos acciones principales que podemos realizar. Confundirlas es el origen de muchos problemas.
- Detener Home Assistant Core: Esta acción detiene únicamente el software de Home Assistant. El sistema operativo subyacente (como Raspberry Pi OS, Debian, etc.) seguirá funcionando. Es útil para realizar tareas de mantenimiento en el sistema operativo sin necesidad de apagar completamente el hardware.
- Apagar el Host (Poweroff Host): Esta es la acción de apagado completo. Detiene tanto el software de Home Assistant como el sistema operativo. La máquina (Raspberry Pi, NUC, servidor) se apagará por completo y dejará de consumir energía. Este es el procedimiento que debes seguir siempre que necesites desconectar físicamente tu servidor.
Métodos para Apagar Home Assistant en 2026
En 2026, disponemos de varios métodos fiables para gestionar el encendido y apagado de nuestro sistema. He aquí los más importantes, ordenados por recomendación de uso.
Método 1: Desde la Interfaz Gráfica (El más recomendado)
Para la gran mayoría de los usuarios, este es el método más seguro y sencillo. La interfaz de Home Assistant proporciona acceso directo a las funciones de control del sistema.
- Navega a Ajustes > Sistema.
- En la esquina superior derecha, haz clic en el icono de encendido.
- Se desplegará un menú con varias opciones. Las dos que nos interesan son:
- Reiniciar Home Assistant: Detiene e inicia de nuevo solo el software Core.
- Apagar el sistema: Realiza un apagado completo y seguro del host. Esta es la opción que buscas para un Poweroff Host total.
Utiliza siempre «Apagar el sistema» antes de desenchufar tu dispositivo de la corriente para evitar cualquier tipo de corrupción de datos.
Método 2: Mediante Servicios (Para Automatizaciones y Scripts)
Si deseas crear botones personalizados en tu panel de control o automatizar el apagado, los servicios son tu mejor aliado. Puedes llamarlos desde scripts o automatizaciones.
Detener Home Assistant Core
Este servicio solo detiene la aplicación Home Assistant, dejando el sistema operativo en funcionamiento. El servicio es homeassistant.stop.
alias: 'Script: Detener solo el Core de HA'
sequence:
- service: homeassistant.stop
data: {}
mode: single
Apagar el Sistema Host (Hassio Shutdown)
Este servicio es el equivalente a pulsar el botón «Apagar el sistema» en la interfaz. Apaga tanto Home Assistant como el sistema operativo. El servicio es hassio.host_shutdown.
alias: 'Script: Apagado completo del sistema'
sequence:
- service: hassio.host_shutdown
data: {}
mode: single
¡Muy importante! Antes de ejecutar cualquier script de reinicio o apagado, siempre es una buena práctica verificar tu configuración desde Ajustes > Sistema > Comprobar configuración para asegurarte de que Home Assistant podrá arrancar sin problemas.
Método 3: Vía Terminal (Para Usuarios Avanzados)
Si tienes acceso al terminal, ya sea a través de SSH o usando la App (anteriormente conocido como Add-on) «Terminal & SSH», puedes usar los comandos de la CLI (Command Line Interface) de Home Assistant para un control más directo.
- Para detener solo el Core:
ha core stop - Para apagar completamente el Host:
ha host shutdown - Para reiniciar el Core:
ha core restart - Para reiniciar el Host:
ha host reboot
Estos comandos son extremadamente útiles para el mantenimiento remoto y la resolución de problemas cuando la interfaz web no está accesible.
Tabla Comparativa de Métodos de Apagado
Para que puedas decidir rápidamente qué método usar en cada situación, he preparado esta tabla comparativa:
| Método | Nivel de Dificultad | Caso de Uso Principal | Riesgo (si se usa mal) |
|---|---|---|---|
| Interfaz Gráfica (GUI) | Muy Bajo | Apagado y reinicio diario. El más seguro para principiantes. | Bajo. Es difícil equivocarse. |
| Servicios (Scripts) | Bajo | Automatizaciones, botones personalizados, apagados programados. | Medio. Un error en la lógica de una automatización podría causar reinicios inesperados. |
| Comandos de Terminal (SSH) | Alto | Mantenimiento avanzado, recuperación de errores, gestión remota. | Alto. Un comando incorrecto puede afectar gravemente al sistema. |
Cómo Programar un Apagado o Reinicio Automático
Gracias a las automatizaciones, puedes programar reinicios para mantener el sistema «fresco» o apagarlo en horarios específicos. Por ejemplo, un reinicio semanal de madrugada puede ayudar a liberar memoria y prevenir problemas de rendimiento.
Este es un ejemplo de una automatización que reinicia Home Assistant todos los domingos a las 4:00 AM:
alias: 'Mantenimiento: Reinicio Semanal'
description: 'Reinicia el host de Home Assistant cada domingo a las 4:00 AM'
trigger:
- platform: time
at: '04:00:00'
condition:
- condition: time
weekday:
- sun
action:
- service: homeassistant.restart
data: {}
mode: single
Si en lugar de reiniciar quisieras un apagado completo, simplemente cambia el servicio homeassistant.restart por hassio.host_shutdown.
Consideraciones por Plataforma
El método de apagado puede tener implicaciones distintas según dónde tengas instalado Home Assistant.
- Home Assistant OS (Raspberry Pi, Green, Yellow): El comando
ha host shutdowno su equivalente en la GUI es vital. Apaga el sistema operativo de forma segura, lo que es crucial para prevenir la corrupción de la tarjeta SD. Si estás usando una Raspberry Pi, asegúrate de tener la mejor tarjeta microSD posible para minimizar riesgos. - Instalación en Docker: Al ejecutar
ha core stopo apagar desde la GUI (si usas la instalación Supervisada), solo detendrás el contenedor de Home Assistant. La máquina anfitriona seguirá encendida. Para apagar el servidor físico, deberás acceder al terminal del host y ejecutarsudo poweroff. - Máquina Virtual (Proxmox, VirtualBox, Synology): De forma similar a Docker, un apagado del host desde Home Assistant apagará el sistema operativo «invitado» (la VM), pero no el hipervisor. Deberás gestionar el apagado del servidor principal desde la interfaz de tu software de virtualización. Si usas Synology, aquí tienes una guía para instalar Home Assistant en una VM.
Troubleshooting: Errores Comunes
- Home Assistant no arranca tras un reinicio: La causa más común es un error en
configuration.yaml. Antes de cada reinicio, comprueba tu configuración. Si el sistema no arranca, necesitarás acceder a tus archivos vía Samba o SSH para revisar los logs y corregir el error. - Corrupción de la base de datos: Suele ocurrir por apagones o por desconectar el dispositivo de la corriente sin un apagado seguro. La mejor solución es la prevención. Si ya es tarde, tu única salida es restaurar desde una copia de seguridad. Te recomiendo encarecidamente configurar copias automáticas, por ejemplo, con la integración de Google Drive para Home Assistant.
En resumen, aunque existen métodos para usuarios avanzados, la forma más fiable y recomendada para apagar Home Assistant en 2026 sigue siendo a través de su interfaz gráfica. Tómate siempre el tiempo para hacerlo correctamente; tu estabilidad y tranquilidad a largo plazo te lo agradecerán.
