Saltar al contenido

Apagar Home Assistant 2026: Guía Segura y Actualizada

22/01/2022

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.

OFERTAS · TIENDA OFICIAL

Descuentos en domótica SONOFF

Interruptores WiFi, relés, sensores, tiras LED y más. Las promociones cambian con frecuencia en la tienda oficial.

Cupón: TECNOYFOTO (10% de descuento al pagar)

Ver ofertas oficiales Enlace de afiliado · Tienda Sonoff

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.

  1. Navega a Ajustes > Sistema.
  2. En la esquina superior derecha, haz clic en el icono de encendido.
  3. 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étodoNivel de DificultadCaso de Uso PrincipalRiesgo (si se usa mal)
Interfaz Gráfica (GUI)Muy BajoApagado y reinicio diario. El más seguro para principiantes.Bajo. Es difícil equivocarse.
Servicios (Scripts)BajoAutomatizaciones, botones personalizados, apagados programados.Medio. Un error en la lógica de una automatización podría causar reinicios inesperados.
Comandos de Terminal (SSH)AltoMantenimiento 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 shutdown o 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 stop o 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 ejecutar sudo 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.