Si Home Assistant te muestra la reparación "Update MariaDB to a supported LTS version to continue using the recorder", tu base de datos es MariaDB 13.0, una versión sin soporte a largo plazo (LTS), y el recorder dejará de usarla en la 2027.3.0. Le pasa a quien tenía mariadb:latest en Docker, porque esa etiqueta saltó a la 13.0.2. El arreglo es volcar la base de datos, arrancar mariadb:12.3 en un directorio de datos vacío y restaurar el volcado. Lo reproduje el 12 de noviembre de 2026 con Home Assistant 2026.11.1 en Linux arm64. Tienes la versión en inglés de esta guía.

Puntos clave

  • Desde la 2026.10, el recorder marca como no compatible cualquier MariaDB fuera de las series LTS 10.11, 11.4, 11.8 y 12.3.
  • Hoy mariadb:latest y mariadb:13 apuntan a la 13.0.2, y mariadb:lts a la 12.3.3.
  • La aplicación MariaDB de Home Assistant OS usa la 11.8 desde su versión 4.0.0, así que no le afecta.
  • Con un millón de estados en states (224 MiB), el volcado tardó 1 segundo y la restauración en 12.3.3, 10,4 segundos.
  • Arrancar la 12.3 sobre los datos de la 13 funcionó en mi prueba, pero MariaDB no da soporte a bajar de versión en el mismo directorio.

¿Por qué Home Assistant dice que MariaDB 13 no es LTS?

Lo dice porque el recorder compara la versión del servidor con una lista de series LTS que se genera desde endoflife.date. La lista entró con el PR #179615[1], fusionado el 20 de agosto de 2026. En la 2026.11.1 contiene 10.11, 11.4, 11.8 y 12.3 para MariaDB, y apunta la 13.0 como la última versión que no es LTS.

El aviso no salía en la 2026.9 aunque ya usaras la 13.0. El código da por buena cualquier serie más nueva que la última que conoce, y la 13.0 no entró en la lista hasta el PR #183037[2], del 24 de septiembre. Desde la 2026.10, el recorder crea esta reparación con gravedad de aviso:

Update MariaDB to a supported LTS version to continue using the recorder
This stops working in version 2027.3.0. Please address before upgrading.
Version 13.0.2 of MariaDB is not a supported long-term support (LTS)
release. [...] please upgrade to one of the supported LTS versions
(10.11, 11.4, 11.8, 12.3) and restart Home Assistant

En español, la interfaz dice "Actualiza MariaDB a una versión LTS compatible para seguir utilizando la grabadora". La 13.0 es una versión rolling: según endoflife.date[3], su soporte acaba el 31 de diciembre de 2026, mientras que el de la 12.3 llega al 12 de junio de 2029. El análisis de MariaDB 13 en Docker explica qué trae esa versión y el calendario de las rolling.

¿A quién le afecta el aviso?

Afecta a quien conecta el recorder a un MariaDB propio cuya serie no está en la lista. En la práctica, es la instalación en contenedores con la etiqueta mariadb:latest o mariadb:13:

Instalación Versión de MariaDB ¿Sale el aviso?
Recorder con SQLite (por defecto) Ninguna No
Aplicación MariaDB de Home Assistant OS 4.0.0 11.8 No
Docker con mariadb:lts o mariadb:12.3 12.3.3 No
Docker con mariadb:latest o mariadb:13 13.0.2 Sí
Series fuera de soporte, como 12.2 12.2 Sí, por el mismo código

La instalación de Home Assistant con Docker usa SQLite si no le pasas un db_url. Si un actualizador automático como Watchtower vigila tu MariaDB, puede que no recuerdes cuándo pasó a la 13: el contenedor no avisa al cambiar de serie. Para saber qué versión tienes, pregunta al servidor:

docker compose exec mariadb mariadb --version

En mi laboratorio respondió mariadb from 13.0.2-MariaDB. El aviso también aparece en Ajustes > Reparaciones.

Por qué no basta con cambiar la etiqueta a mariadb:12.3

Cambiar la imagen y reutilizar el mismo directorio de datos es bajar de versión en el sitio, y MariaDB no lo soporta. La documentación de MariaDB[4] es tajante: "Downgrading is not officially supported, and MariaDB does not test in-place downgrades". Recomienda un volcado lógico y una restauración.

Aun así, lo probé sobre una copia. La 12.3.3 arrancó sobre los datos de la 13.0.2 con el mensaje MariaDB upgrade not required, y Home Assistant funcionó sin errores y sin la reparación. Las tablas del sistema tienen las mismas 257 columnas en las dos versiones, lo que explica que no fallara. Pero el fichero mariadb_upgrade_info siguió diciendo 13.0.2, y nadie garantiza que la próxima diferencia de formato sea tan inocua.

Hay además un caso en el que falla seguro. Si activaste el archivado del redo log de la 13 (innodb_log_archive), la 12.3.3 no arranca con File ./ib_logfile0 was not found, como medí en el análisis de la 13. El volcado no depende de nada de eso.

Cómo pasar de MariaDB 13 a 12.3 con mariadb-dump

El método que recomiendo es volcar solo la base de datos de Home Assistant, crear un MariaDB 12.3 vacío y restaurar ahí. Estos son los pasos que seguí con un compose.yaml que monta los datos en ./mariadb y define MARIADB_DATABASE, MARIADB_USER y MARIADB_PASSWORD, como en la guía para instalar MariaDB con Docker.

Primero, para Home Assistant, para que no escriba nada después del volcado, y vuelca la base de datos con la contraseña de root que ya tiene el contenedor:

docker compose stop homeassistant
docker compose exec -T mariadb sh -c 'exec mariadb-dump -uroot \
  -p"$MARIADB_ROOT_PASSWORD" --single-transaction --routines \
  --triggers --events --databases homeassistant' > ha-13.sql

La opción --databases añade el CREATE DATABASE al volcado y deja fuera las tablas de usuarios, que el nuevo contenedor crea solo. Después para MariaDB, aparta el directorio de la 13 y cambia la imagen:

docker compose stop mariadb
mv mariadb mariadb-13
sed -i 's/image: mariadb:13/image: mariadb:12.3/' compose.yaml
docker compose up -d mariadb

Si tu compose.yaml dice mariadb:latest, cambia esa etiqueta. Como el directorio está vacío, el contenedor crea la base de datos y el usuario con las variables de siempre. Espera a que el registro muestre MariaDB init process done y restaura:

docker compose exec -T mariadb sh -c \
  'exec mariadb -uroot -p"$MARIADB_ROOT_PASSWORD"' < ha-13.sql
docker compose up -d homeassistant

La 12.3.3 aceptó el volcado de la 13.0.2 sin tocarlo, incluida la primera línea /*M!999999\- enable the sandbox mode */ que añade el cliente nuevo. Al arrancar, Home Assistant no creó la reparación y el historial seguía ahí: la API devolvió 7184 puntos de una entidad para los últimos tres días. Guarda mariadb-13 y ha-13.sql hasta comprobar que todo funciona; volver atrás es restaurar la imagen y el directorio.

Cuánto tarda el volcado y la restauración

El tiempo lo marca la restauración, que reconstruye los índices de states. Lo medí con un millón de filas sintéticas en states, 224 MiB entre datos e índices, sobre los mismos contenedores. El volcado ocupó 132 MiB:

Volcar en MariaDB 13.0.2 y restaurar en 12.3.3 la base de datos de Home Assistant s · menos es mejor
Volcado con mariadb-dump en 13.0.2
0,99 s
Restauración en 12.3.3
10,35 s
Ver tabla de valores
Pasos
Volcado con mariadb-dump en 13.0.20,99 s
Restauración en 12.3.310,35 s

Mediana de tres ejecuciones, un millón de filas en states (224 MiB), Docker 29.5.2 en Linux arm64 con 18 núcleos, 12 de noviembre de 2026.

Mientras Home Assistant está parado no graba nada, así que el historial queda con un hueco del tiempo que tardes en todo el proceso. Para no alargarlo, prepara el compose.yaml y los comandos antes de parar el contenedor.

¿Qué etiqueta de MariaDB poner para que no vuelva a pasar?

Pon una etiqueta de serie LTS concreta, mariadb:12.3, y no latest. La etiqueta lts también sirve hoy, pero cambiará de serie cuando salga la siguiente LTS, y un cambio de serie mayor en un contenedor que se actualiza solo es justo lo que provocó este aviso:

Etiqueta Apunta hoy a Cambia de serie sola
mariadb:latest 13.0.2 Sí, con cada rolling
mariadb:13 13.0.2 Sí, a la 13.1 y siguientes
mariadb:lts 12.3.3 Sí, con la próxima LTS
mariadb:12.3 12.3.3 No, solo parches de la 12.3

Quedarte en la 13 y pasar a la 13.1 no es una solución. Con la lista actual, Home Assistant no avisa por una serie que todavía no conoce. La reparación vuelve en cuanto una versión de Home Assistant añade la 13.1 a la lista.

En la incidencia #186992[5], abierta el 17 de octubre con 30 reacciones, se pide aplazar la retirada hasta que salga la 13.3 LTS. A 12 de noviembre nadie del equipo había respondido.

Preguntas frecuentes

¿Puedo ignorar la reparación hasta 2027?

Puedes pulsar Ignore y el aviso desaparece del panel, pero el plazo sigue. La reparación dice que deja de funcionar en la 2027.3.0. Si no cambias de versión antes, no actualices Home Assistant a esa versión.

¿Pierdo el historial o las estadísticas al bajar a 12.3?

No, si restauras el volcado completo de la base de datos homeassistant. En mi prueba, los 1 000 016 estados y la versión 53 del esquema del recorder llegaron intactos a la 12.3.3. Las estadísticas a largo plazo están en tablas de la misma base de datos, así que viajan en el mismo volcado.

¿Me afecta si uso MySQL en lugar de MariaDB?

Puede afectarte por el mismo código. Para MySQL, la lista de Home Assistant 2026.11.1 da por compatibles las series LTS 8.4 y 9.7, y marca como no LTS las versiones de innovación hasta la 26.10. No lo he probado con MySQL.

Conclusión

El aviso de Home Assistant sobre MariaDB LTS sale porque mariadb:latest pasó a la 13.0, una rolling con soporte hasta finales de 2026, y el recorder dejará de aceptarla en la 2027.3.0. Vuelca la base de datos con mariadb-dump, arranca mariadb:12.3 en un directorio vacío y restaura: con un millón de estados fueron 11 segundos. No reutilices el directorio de la 13 aunque arranque, porque MariaDB no soporta bajar de versión. Si quieres saber si te afecta ahora, mira Ajustes > Reparaciones o ejecuta mariadb --version en tu contenedor.

Fuentes: [1] Home Assistant, incidencia #186992: Postpone removal of support for MariaDB short-term releases[5], [2] Home Assistant, PR #179615: Add repairs for upcoming bumps of minimum supported db engine versions[1], [3] Home Assistant, PR #183037: Update recorder database versions for MariaDB 13.0[2], [4] Documentación del recorder de Home Assistant: MariaDB y MySQL[6], [5] MariaDB, bajar de versión entre versiones mayores[4], [6] endoflife.date: MariaDB[3], [7] Registro de cambios de la aplicación MariaDB de Home Assistant[7], [8] Etiquetas de la imagen mariadb en Docker Hub[8].

Fuentes

  1. PR #179615
  2. PR #183037
  3. endoflife.date
  4. documentación de MariaDB
  5. incidencia #186992
  6. Documentación del recorder de Home Assistant: MariaDB y MySQL
  7. Registro de cambios de la aplicación MariaDB de Home Assistant
  8. Etiquetas de la imagen mariadb en Docker Hub