Tutoriales Home Assistant / octubre 30, 2025

Cómo convertir la base de datos de Home Assistant a MariaDB

Mejora el rendimiento de Home Assistant migrando de SQLite a MariaDB de forma sencilla.

Don T3rr0rZ0n3

3 minutos

Por defecto, Home Assistant utiliza una base de datos SQLite para almacenar los registros de sensores, automatizaciones, eventos y estadísticas del sistema. Aunque SQLite funciona bien en instalaciones pequeñas, puede volverse lenta a medida que el número de dispositivos, integraciones o automatizaciones aumenta.

Si notas que tus paneles tardan en cargar, los gráficos de historial son lentos o el sistema se vuelve menos fluido, es probable que tu base de datos SQLite se haya convertido en un cuello de botella.

En este artículo aprenderás cómo migrar tu base de datos de Home Assistant a MariaDB, una alternativa mucho más rápida y robusta que mejorará notablemente el rendimiento general.

¿Por qué usar MariaDB?

SQLite es una base de datos ligera y sencilla, ideal para entornos con pocos datos. Sin embargo, tiene limitaciones importantes:

  • No está pensada para manejar escrituras concurrentes.
  • Satura el sistema cuando hay muchos sensores o integraciones.
  • No escala bien cuando el fichero de base de datos supera varios cientos de MB.

Por el contrario, MariaDB (un derivado libre de MySQL) está diseñada para manejar grandes volúmenes de información, múltiples conexiones simultáneas y consultas más complejas sin afectar al rendimiento de Home Assistant.

Instalar MariaDB en Home Assistant

Vamos a Configuración - Complementos y allí, al botón de abajo a la derecha que pone Tienda de Complementos y buscamos MariaDB:

Hacemos clic sobre el complemento y luego a Instalar, esperamos a que se instale el complemento.

Una vez instalado, antes de iniciar, primero de todo marcamos la opción de Vigilancia y luego vamos a la pestaña de Configuración.

Aquí en el apartado de Logins, hacemos clic en el lápiz para editar y configuramos una contraseña segura.

💡
La contraseña no puede tener @ u otros caracteres especiales.

Le damos a guardar y seguidamente volvemos a la pestaña de Información e iniciamos el complemento.

Tras iniciar el complemento, vamos a la pestaña de Registros y revisamos que se vea lo siguiente:

Y listo, ya podemos continuar con el tutorial.

Configurar Home Assistant para usar MariaDB

Edita tu archivo configuration.yaml y añade (o modifica) la sección recorder:

recorder:
  db_url: mysql://homeassistant:password@core-mariadb/homeassistant?charset=utf8mb4
  commit_interval: 30
  purge_keep_days: 60
  • commit_interval controla cada cuánto se escriben los datos (reduce carga de disco).
  • purge_keep_days indica cuántos días de historial mantener.
💡
Recuerda de cambiar password por la contraseña que has seleccionado anteriormente.

Guarda los cambios y reinicia Home Assistant.

Comprobación del cambio

Tras iniciar, podemos ir a Historial y seleccionamos algunas entidades, si vemos que se están actualizando y almacenando el historial, significa que funciona correctamente

Limpieza posterior

Tras reiniciar, Home Assistant comenzará a crear la nueva base de datos en MariaDB.
Si quieres eliminar la antigua base de datos SQLite (para liberar espacio), borra el archivo home-assistant_v2.db ubicado en tu directorio /config.

Antes de hacerlo, asegúrate de que Home Assistant ya se ha iniciado correctamente y no muestra errores en los logs.

Conclusión

Migrar de SQLite a MariaDB es una de las mejoras de rendimiento más efectivas que puedes hacer en Home Assistant.
Notarás una interfaz más fluida, paneles que cargan más rápido y un historial mucho más estable, incluso con cientos de sensores o integraciones activas.

Si gestionas una instalación grande o usas Home Assistant en un entorno virtualizado con muchos dispositivos, usar MariaDB no es solo recomendable, sino casi obligatorio.

Más sobre ./voidNull

Haz que cada palabra cuente: tu donación nos inspira a seguir creando contenido. Accede al apartado de Donación para hacer tu aportación