Actualizado el 25 de marzo de 2026
Perder el acceso a tu instancia de Home Assistant es una de las situaciones más estresantes para cualquier entusiasta de la domótica. Ya sea por un simple olvido, una actualización fallida que corrompió algo, o tras un cambio de hardware, quedarse fuera de tu centro de control puede ser un verdadero dolor de cabeza. Afortunadamente, en 2026 existen varios métodos probados para recuperar la contraseña de Home Assistant, y en esta guía definitiva te los explicaré todos, paso a paso.
Causas Comunes de la Pérdida de Acceso
Antes de sumergirnos en las soluciones, es útil entender por qué ocurre esto. Las razones más habituales por las que he tenido que ayudar a otros usuarios (o a mí mismo) son:
- Olvido de la contraseña: La causa más simple y frecuente.
- Actualización fallida: Una actualización de Home Assistant Core o del sistema operativo que no se completa correctamente puede, en raras ocasiones, afectar los archivos de autenticación.
- Corrupción de la tarjeta SD o SSD: El fallo del medio de almacenamiento es un problema conocido, especialmente en instalaciones sobre Raspberry Pi.
- Cambio de hardware: Al migrar una instalación a un nuevo dispositivo, si no se restauran los backups correctamente, pueden surgir problemas de acceso.
Método 1: Aún tienes una sesión activa
Si has tenido la suerte de olvidar tu contraseña pero tu sesión sigue activa en un navegador o en la app móvil, estás en el mejor escenario posible. La solución es rápida y no requiere acceso a la consola.
- Navega a Ajustes > Personas.
- Haz clic en «Añadir persona» en la esquina inferior derecha.
- Crea un nuevo usuario, asígnale una contraseña que recuerdes y, muy importante, activa el interruptor para que sea Administrador.
- Cierra la sesión de tu usuario actual.
- Inicia sesión con el nuevo usuario administrador.
- Vuelve a Ajustes > Personas, selecciona tu usuario original y ahora tendrás la opción de «Cambiar contraseña» para restablecerla.
Una vez recuperado el acceso a tu cuenta principal, puedes eliminar el usuario temporal que creaste. Tu configuración y paneles de control permanecerán intactos.
Método 2: Restablecer Contraseña con Acceso a la Consola (Recomendado para Home Assistant OS)
Este es el método oficial y más seguro para instalaciones de Home Assistant OS (en Raspberry Pi, ODROID, o máquinas virtuales). Requiere acceso a la línea de comandos (CLI) de Home Assistant.
Paso 1: Acceder a la Consola de Home Assistant
Tienes dos formas de hacerlo:
- Acceso Físico: Conecta un teclado y un monitor directamente a tu dispositivo (por ejemplo, tu Raspberry Pi). Al arrancar, verás la consola. Pulsa «Enter» para activarla.
- Acceso Remoto (SSH): Si tienes instalada y configurada la App (anteriormente conocido como Add-on) de «Terminal & SSH», puedes conectarte remotamente desde otro ordenador.
Paso 2: Ejecutar el Comando de Reseteo
Una vez en la línea de comandos, que reconocerás por el prompt ha >, introduce el siguiente comando para restablecer la contraseña de Home Assistant. Asegúrate de reemplazar TU_USUARIO_EXISTENTE por tu nombre de usuario real y NUEVA_CONTRASEÑA_SEGURA por la nueva clave que deseas establecer.
ha auth reset --username TU_USUARIO_EXISTENTE --password NUEVA_CONTRASEÑA_SEGURATras ejecutarlo, el sistema confirmará el cambio. ¡Ya puedes volver a la interfaz web e iniciar sesión con tu nueva contraseña!
Método 3: Eliminar los Archivos de Autenticación (Último Recurso)
Si utilizas una instalación de Home Assistant Container (Docker) o no tienes acceso a la consola por ningún medio, este es tu plan B. Este método implica eliminar todos los datos de usuarios y autenticación, forzando al sistema a iniciar el proceso de bienvenida de nuevo para que puedas crear una cuenta de propietario desde cero.
¡Atención! Este proceso eliminará TODOS los usuarios, pero NO afectará a tus entidades, automatizaciones, scripts o paneles de Lovelace.
- Detén Home Assistant. Si usas Docker, ejecuta
docker stop home-assistant(o el nombre de tu contenedor). - Accede a tu carpeta de configuración. Esta es la carpeta donde reside tu archivo
configuration.yaml. La forma más sencilla de acceder es a través de la App de Samba si la tenías instalada. - Navega hasta la subcarpeta oculta llamada
.storage. - Dentro de
.storage, elimina los siguientes archivos:authauth_provider.homeassistantonboardinghassiocloud
- Reinicia Home Assistant.
Al volver a acceder a la interfaz web, serás recibido por la pantalla de creación de una nueva cuenta de propietario, como si fuera una instalación nueva. Crea tu usuario y contraseña, y volverás a tener control total sobre tu sistema.
Preguntas Frecuentes (FAQ) sobre la Recuperación de Contraseña
¿Qué hago si olvidé mi nombre de usuario?
Si no recuerdas el nombre de usuario, el método de la consola no funcionará. En este caso, tu única opción es el Método 3: eliminar los archivos de autenticación para reiniciar el proceso de alta de usuario.
¿Cómo puedo acceder a los archivos si no tengo Samba configurado?
Si tu instalación está en una tarjeta SD o un disco SSD, puedes apagar el sistema, extraer el medio de almacenamiento y conectarlo a otro ordenador.
| Sistema Operativo | Método de Acceso |
|---|---|
| Linux | El acceso es nativo. La partición de datos (normalmente llamada hassos-data) se montará automáticamente. |
| Windows | Necesitarás un software de terceros como Linux File Systems for Windows by Paragon Software o DiskInternals Linux Reader para poder leer particiones EXT4. |
| macOS | Puedes usar herramientas como ext4fuse a través de FUSE para macOS para montar la partición. |
Una vez montada, la ruta a tu configuración suele ser /mnt/data/supervisor/homeassistant/.
¿Cómo prevenir la pérdida de contraseña en el futuro?
La prevención es la mejor estrategia. Te recomiendo encarecidamente:
- Usa un gestor de contraseñas: Herramientas como Bitwarden, 1Password o KeePass son esenciales en 2026 para generar y almacenar contraseñas seguras y únicas.
- Crea un usuario administrador de respaldo: Tal como se describe en el Método 1, tener un segundo usuario administrador guardado en tu gestor de contraseñas te puede salvar en un apuro. Puedes aprender más sobre esto en nuestra guía de gestión de usuarios en Home Assistant.
- Activa la Autenticación de Múltiples Factores (MFA): En Ajustes > Personas, selecciona tu usuario y ve a la pestaña «Credenciales». Aquí puedes añadir un autenticador como Google Authenticator o Authy para una capa extra de seguridad en Home Assistant.
- Realiza copias de seguridad automáticas: Configura backups periódicos, por ejemplo, usando la integración de Google Drive, para poder restaurar tu sistema a un punto anterior si todo lo demás falla.