Actualizar Moodle 4.5 a 5: Guía Práctica de Quien Ya lo Ha Hecho
El 5.3 LTS ya está disponible y el 4.5 pierde soporte de seguridad en 2027. Base de datos, carpeta /public, plugins y rollback: lo que frena la actualización en la práctica.
por Cleverson Gouvêa

Quien necesita actualizar Moodle 4.5 a 5 hoy tiene una decisión más importante de lo que parece: el destino correcto, la base de datos asociada y la carpeta public que cambia el servidor web. Moodle 5.3 LTS fue lanzado el 5 de octubre de 2026, y la ventana de seguridad del 4.5 cierra en octubre de 2027. Esta es la lista de verificación que sigo, desde el inventario hasta el plan de reversión.
TL;DR
- Destino: opte por el 5.3 LTS (soporte de seguridad hasta el 01/10/2029). El 5.2 tiene soporte de seguridad solo hasta el 04/10/2027, la misma fecha que el 4.5: haría todo el trabajo sin ganar un día de soporte.
- Lo que más frena: la base de datos. El 5.3 requiere MariaDB 11.4, PostgreSQL 17 o MySQL 8.4, y PHP 8.3. La mayoría de los servidores que ejecutan 4.5 no cumplen.
- Lo que más problemas causa: la carpeta
/public(desde el 5.1), el enrutador obligatorio (r.php) y plugins de terceros que necesitan ser movidos y actualizados.- Rollback: Moodle no permite el downgrade. Revertir es restaurar código,
moodledatay base de datos del mismo instante. Sin esos tres, no existe un plan B.- Cuándo: homologue ahora, ejecute en producción después del 5.3.1 (previsto para el 07/12/2026) y fuera de la semana de exámenes.
Administro entornos Moodle desde 2008 y ya he guiado a instituciones a través de varios ciclos LTS. La parte difícil de actualizar nunca es el comando de actualización. Es el servidor que nadie actualiza desde hace años, el plugin que un proveedor abandonó y la falta de un camino de reversión probado. De eso trata esta guía, para quienes son responsables del EVA (Entorno Virtual de Aprendizaje) de una institución: coordinación de EAD o TI.
¿A qué versión actualizar Moodle 4.5 a 5 en 2026? El calendario decide
LTS significa Long-Term Support, soporte a largo plazo. Moodle lanza dos versiones al año, en abril y octubre, y una de cada tres es LTS. El 4.5 es la LTS de octubre de 2024. La próxima es el 5.3, lanzado recientemente. Las fechas a continuación son las publicadas en la página oficial de lanzamientos de Moodle:
| Versión | Lanzamiento | Correcciones generales hasta | Seguridad hasta |
|---|---|---|---|
| 4.5 (LTS) | 07/10/2024 | 06/10/2025 | 04/10/2027 |
| 5.1 | 06/10/2025 | 05/10/2026 | 19/04/2027 |
| 5.2 | 20/04/2026 | 19/04/2027 | 04/10/2027 |
| 5.3 (LTS) | 05/10/2026 | 04/10/2027 | 01/10/2029 |
La lectura importante: el 4.5 ya no recibe correcciones de errores comunes desde octubre de 2025. Solo parches de seguridad. Y el 5.2, que mucha gente aún considera "la versión estable", pierde el soporte de seguridad el mismo día que el 4.5.
Por eso, cuando alguien me pide actualizar Moodle 4.5 a 5 en este momento, la respuesta es casi siempre el 5.3 LTS. El salto directo está soportado: el 5.3 acepta la actualización desde Moodle 4.4 o superior, según las notas de lanzamiento del 5.3. No hay una etapa intermedia obligatoria.
¿Cuándo tiene sentido quedarse en el 5.2?
Casi nunca. La excepción es la institución que necesita una característica del 5.2 ya, tiene un plugin crítico que aún no ha declarado compatibilidad con el 5.3 y acepta repetir el proceso en 2027. Fuera de eso, es migrar dos veces para llegar al mismo lugar.
Requisitos: el servidor que ejecuta el 4.5 rara vez ejecuta el 5.3
Aquí reside la razón principal de los proyectos atrasados. Los requisitos han aumentado en cada lanzamiento desde el 4.5, y el 5.3 ha vuelto a subir en la base de datos. Comparando los requisitos mínimos oficiales:
| Componente | Moodle 4.5 | Moodle 5.3 LTS |
|---|---|---|
| PHP | 8.1.0 | 8.3.0 (8.4 soportado) |
| MariaDB | 10.6.7 | 11.4.0 |
| PostgreSQL | 13 | 17 |
| MySQL | 8.0 | 8.4 |
| SQL Server | 2017 | 2019 |
| Oracle | 19c | no soportado (desde el 5.0) |
| Actualización desde | 4.1.2 | 4.4 |
Fuentes: páginas de lanzamiento del 4.5 y del 5.3.
Quien va a actualizar Moodle 4.5 a 5 necesita revisar la base de datos primero, porque es lo que pilla a las instituciones desprevenidas. Quien hizo la actualización al 5.0 o 5.1 en 2025 subió a MariaDB 10.11 y pensó que estaba resuelto. Para el 5.3, el mínimo pasó a ser 11.4.0. En PostgreSQL, el requisito mínimo subió a la versión 17.
El lado positivo: el calendario de la base de datos también mejora
MariaDB 11.4 tiene soporte hasta el 29/05/2029 y PostgreSQL 17 hasta el 08/11/2029, según endoflife.date. Es decir, la nueva base de datos acompaña el fin del soporte del 5.3 LTS. PostgreSQL 14 pierde soporte el 12/11/2026, y MariaDB 10.6 ya lo perdió en julio de 2026. Si su servidor está en esa situación, el problema es anterior a Moodle.
Los tres requisitos de PHP que hacen fallar la instalación
- Solo PHP de 64 bits. Raro en Linux, común en servidores Windows heredados.
- Extensión
sodiumobligatoria. En muchas distribuciones viene en un paquete separado. max_input_varsmayor o igual a 5000. El valor predeterminado de PHP es 1000. Con él, formularios grandes, como la página de calificaciones de una clase llena, guardan solo la mitad sin mostrar error.
El detalle completo de CPU, RAM y dimensionamiento está en nuestra guía de requisitos de servidor para Moodle 5.x. Antes de nada, abra Administración del sitio → Servidor → Verificación del entorno: el propio Moodle muestra en rojo lo que impide la actualización.
La carpeta /public y el enrutador: el cambio que requiere modificar el servidor web
Moodle 5.1 reorganizó los archivos. Todo lo accesible por la web pasó a una subcarpeta /public, y los archivos sensibles quedan por encima de ella. Quien va a actualizar Moodle 4.5 a 5 nunca ha pasado por esto, así que esta etapa recae completamente en su actualización.
En la práctica, tres cosas cambian:
- El DocumentRoot cambia. El servidor web (Apache o Nginx) debe apuntar a
moodle/public, y no amoodle. La documentación oficial de actualización es directa: sin reconfigurar el servidor, la actualización no avanza. - El
config.phpqueda en la raíz. Vuelve a la carpeta principal de Moodle, no dentro depublic. - Plugins de terceros necesitan ser movidos. Los que ya estaban instalados continúan en su ubicación antigua, por encima de
/public. Cada uno debe ir a la ruta equivalente dentro de la nueva estructura. Las notas del 5.1 lo advierten con todas las letras.
El enrutador dejó de ser opcional
Junto con la carpeta public vino el enrutador de Moodle. Según la documentación Configuring the Router, la configuración es obligatoria a partir del 5.1. En Apache, esto es un FallbackResource /r.php dentro del bloque <Directory>. En Nginx, un try_files $uri /r.php;. Después, usted informa a Moodle con $CFG->routerconfigured = true; en el config.php.
Olvidar el enrutador no tumba el sitio entero. Genera páginas específicas en 404 y un alerta de "router not configured" en la verificación del entorno. Es el tipo de defecto que solo aparece cuando un profesor intenta abrir una pantalla poco usada, días después.
Lo que se elimina del núcleo entre el 4.5 y el 5.3
Este es el ítem que la coordinación pedagógica necesita revisar antes que TI. Al actualizar Moodle 4.5 a 5 usted hereda de una vez todo lo que se eliminó del núcleo entre las versiones 5.0 y 5.3, según las notas oficiales:
- Editor Atto (5.0): TinyMCE toma el relevo. El contenido antiguo permanece; lo que cambia es el editor que usa el profesor.
- Actividades Chat y Encuesta (Survey) (5.0): salen del paquete estándar. Si algún curso los utiliza, decida antes qué hacer con los datos.
- Autenticación CAS y todos los plugins de MNet (5.0): si el inicio de sesión institucional depende de CAS, esto es un impedimento. Necesita una alternativa (SAML, OAuth 2) antes de la fecha.
- Filtro MimeTeX (5.2): quien usa fórmulas en TeX necesita verificar el filtro configurado.
- Tema Classic (5.3): quien aún ejecuta Classic, o un tema hijo de este, necesita migrar a Boost o a un tema propio compatible.
Ninguno de estos ítems aparece como error en la actualización. Aparecen como un profesor quejándose el lunes. Por eso entran en el inventario, no el día del cambio.
Plugins: el inventario que decide el plazo
En casi todo proyecto para actualizar Moodle 4.5 a 5 que dirijo, el cronograma se define por el plugin más atrasado, no por Moodle. El proceso que funciona:
1. Liste todo lo que no es del núcleo
En Administración del sitio → Plugins → Resumen de plugins, filtre los adicionales. Exporte la lista. Para cada uno, anote: quién lo mantiene, versión instalada, si está en uso y de qué curso depende.
2. Clasifique en tres grupos
- Compatible: el directorio de plugins de Moodle ya declara soporte para el 5.3. Descargue la nueva versión.
- Sin señal de vida: última versión antigua, autor sin respuesta. Aquí reside el riesgo real. O alguien asume el mantenimiento, o el plugin se elimina.
- Hecho a medida: desarrollado para la institución. Necesita una revisión de código contra las APIs descontinuadas, que el 5.2 marcó como eliminación final de métodos antiguos de las versiones 2.x, 3.x y 4.x.
3. Elimine lo que nadie usa
Un plugin instalado y sin uso es solo un coste de actualización. Actualizar Moodle 4.5 a 5 es el mejor momento para desinstalar lo que quedó de proyectos antiguos. Menos plugins, menos superficie de ataque y menos tiempo de homologación.
Lista de verificación para actualizar Moodle 4.5 a 5 sin sorpresas
Esta es la secuencia que sigo. Parte de un entorno de homologación, una copia fiel de producción donde todo se prueba antes.
Antes (2 a 6 semanas)
- Ejecutar la verificación del entorno apuntando al 5.3.
- Actualizar PHP 8.3 y la nueva base de datos (MariaDB 11.4 o PostgreSQL 17) en homologación.
- Clonar producción a homologación: código,
moodledatay base de datos. - Realizar el inventario de plugins y resolver los bloqueantes.
- Probar con profesores reales los flujos críticos: cuestionario, envío de tarea, libro de calificaciones, emisión de certificado, matrícula automática.
- Medir el tiempo de la actualización en homologación. Este número define la ventana de mantenimiento.
El día de la actualización
- Avisar a alumnos y profesores con antelación, con fecha y hora de la interrupción.
- Activar el modo de mantenimiento. El script de actualización no lo hace solo.
- Realizar la copia de seguridad completa de los tres elementos (vea la próxima sección).
- Cambiar el código, copiar el
config.phpa la raíz, mover los plugins dentro de/public. - Ajustar DocumentRoot y enrutador en el servidor web.
- Ejecutar la actualización por línea de comandos con
php admin/cli/upgrade.php, la opción que la documentación recomienda para sitios grandes. - Purgar cachés, revisar la verificación del entorno y probar los flujos críticos antes de liberar.
Después (primera semana)
Después de actualizar Moodle 4.5 a 5 acompañe los logs de error de PHP, tareas programadas (cron) y tiempo de respuesta. Una actualización grande suele reconstruir índices y cachés, y el primer día de uso real es más pesado. Si el EVA se ralentiza, la guía de diagnóstico de Moodle lento ayuda a separar un problema de actualización de un problema antiguo de infraestructura.
Rollback: el plan B que debe existir antes de empezar
Antes de actualizar Moodle 4.5 a 5 sepa: Moodle no tiene downgrade. Una vez que la actualización graba la nueva versión en la base de datos, el código antiguo se niega a ejecutarse sobre ella. Revertir significa restaurar el estado anterior completo.
La documentación oficial enumera los tres elementos de la copia de seguridad, y todos deben ser del mismo instante:
| Elemento | Qué es | Cómo se hace |
|---|---|---|
| Código | La carpeta de Moodle con plugins y config.php |
Mantener la carpeta antigua intacta y subir la nueva al lado |
| moodledata | Archivos subidos, cachés, sesiones | Copia con rsync con el sitio en mantenimiento |
| Base de datos | Todas las tablas | Dump completo (o snapshot del volumen) después de activar el mantenimiento |
Tres reglas que hacen que la reversión sea real, y no solo una intención:
- Pruebe la restauración en homologación. Una copia de seguridad nunca restaurada es una hipótesis. Tenemos un artículo completo sobre esto: copia de seguridad de Moodle y la rutina de restauración.
- Defina el criterio de reversión antes. Ejemplo: si en dos horas después de la actualización el cuestionario o el libro de calificaciones no funciona, se revierte. Decidido la víspera, no a las 23h con el director al teléfono.
- Todo lo que se introduzca después de la actualización se pierde en la reversión. Por eso la liberación para los alumnos solo ocurre después de las pruebas finales.
Cuándo NO actualizar ahora
Actualizar Moodle 4.5 a 5 es obligatorio hasta octubre de 2027, para quien quiera seguir recibiendo parches de seguridad. Hacerlo esta semana, no. Retrase la actualización cuando:
- Sea semana de exámenes, cierre de calificaciones o inicio de semestre. La ventana adecuada es la de menor uso, y está en el calendario académico, no en el de TI.
- Algún plugin crítico no tenga versión para el 5.3. Ejecutar el nuevo Moodle sin la integración con el sistema académico es peor que esperar unos meses.
- No haya homologación. Actualizar directamente en producción, saltando tres ciclos de cambio, es una apuesta.
- Usted esté pensando en hacerlo el día del lanzamiento. El 5.3.0 acaba de ser lanzado. El calendario oficial prevé el 5.3.1 para el 07 de diciembre de 2026. Homologar ahora y pasar a producción después de esta primera corrección es el ritmo que recomiendo.
Esperar demasiado también tiene un coste. Quien lo deje para septiembre de 2027 competirá por la ventana con el propio semestre y, días después, se quedará sin parches de seguridad.
Cómo Agathas Web resuelve esto
Actualizar Moodle 4.5 a 5 es exactamente el tipo de proyecto descrito en nuestra página de servicios Moodle. Nuestro equipo cuenta con la Moodle Developer Certification, de Moodle Academy, y realiza migraciones entre versiones, desde la línea 3.x hasta la 5.x, y entre servidores. Somos una empresa independiente de servicios, no un Moodle Partner.
En la práctica, el proceso es el siguiente:
- Diagnóstico gratuito de 1 hora. Entendemos la versión actual, el servidor, los plugins, las integraciones y el calendario académico.
- Propuesta técnica. Documento con la versión de destino, la infraestructura necesaria, la lista de plugins y qué hacer con cada uno, cronograma e inversión. La facturación considera la complejidad de la base de datos y el volumen de datos, y la propuesta se entrega en un máximo de 5 días hábiles.
- Homologación y ejecución. Montamos la copia de producción, resolvemos plugins y tema, probamos con su equipo y ejecutamos el cambio en la ventana acordada, con copia de seguridad y criterio de reversión definidos previamente.
- Seguimiento tras la puesta en marcha. Hacemos un seguimiento cercano durante las primeras semanas.
Quien no quiera pasar por esto en cada ciclo puede mantener el entorno en soporte con un SLA mensual: actualizaciones de seguridad y de versión, monitorización 24/7, copia de seguridad verificada y soporte por WhatsApp en horario comercial, a partir de 800 €/mes. El código de los plugins personalizados y los datos quedan con la institución, sin lock-in. Si el cuello de botella es el servidor, el alojamiento Moodle ya viene con PHP, base de datos y caché ajustados para la nueva versión.
Para agendar el diagnóstico, utilice el formulario o el WhatsApp de la página de servicios Moodle de Agathas Web.
Conclusión: actualizar Moodle 4.5 a 5 es un proyecto, no un comando
El camino en una frase: vaya directamente al 5.3 LTS, empiece por la base de datos y PHP, trate la carpeta /public y el enrutador como parte del alcance, haga el inventario de plugins antes de fijar una fecha y solo pase a producción con la reversión probada.
El plazo real es el 04 de octubre de 2027, cuando el 4.5 deja de recibir soporte de seguridad. Para una institución con dos semestres de por medio, eso es menos tiempo de lo que parece. Quien empieza la homologación ahora pasa a producción con calma durante el receso. Quien lo deje para después actualizará Moodle 4.5 a 5 con prisa, y la prisa es donde la actualización falla.
Si desea un cronograma realista para su entorno, solicite el diagnóstico gratuito en servicios Moodle. Obtendrá la versión de destino, la lista de impedimentos y una ventana sugerida.
Posts relacionados

PHP2Shell Moodle: Guía de acción para el administrador de tu AVA
Dos fallos críticos en PHP permiten acceder al servidor de Moodle sin autenticación. La guía paso a paso para corregir hoy mismo y detectar si ha habido intrusiones.

Moodle PHP Obsoleto tras PHP2Shell: Riesgo, Coste y Plan de Migración
PHP 7.4 a 8.1 no tiene corrección oficial de PHP2Shell. Descubra qué cubren los backports y la ruta segura hasta Moodle 4.5 LTS.

Actualizar PHP Moodle: 8.3.36 o 8.4.27 sin Romper Plugins
Moodle 4.5 no funciona con PHP 8.4. Descubra qué versión corregida usar en su EVA, cómo homologar y cómo revertir si algo falla.