Cómo actualizar Moodle: La Guía (2026)

Actualizar Moodle es una de las tareas que son necesarias para tener las últimas novedades y mantenerlo seguro. Lo he dicho muchas veces: amo a Moodle, pero no su sistema de actualización 😁.

Se echa de menos poder hacerlo con un solo clic, tal como lo hacen otros manejadores de contenido.

Así que, mientras esperamos a que llegue esta funcionalidad, te enseñaré todo lo que debes saber para actualizar Moodle desde las versiones 1.X hasta la 5.X (pasando por todas las versiones intermedias) y no morir en el intento.

¿Cuál versión de Moodle tienes?

Lo primero que debes conocer para ejecutar una actualización, es saber cual versión de Moodle corres en tu servidor. Es posible que lo hayas instalado hace mucho tiempo y ya te olvidaste hasta la versión que tenías. No te preocupes, eso suele pasar en el mundo de Moodle muy a menudo. 😉

Para conocer esto, es necesario que te loguees como administrador y vayas a la pestaña: Administración del sitio (“Administración” en versiones antiguas) > Notificaciones. Podrás observar en esta pantalla, al final, que versión de Moodle tienes instalada.

Sabiendo esto, podemos hacer un plan para actualizar Moodle. Lo sencillo o complicado que sea este proceso va a depender de la antigüedad del mismo.

La versión actual al momento de escribir este artículo es la 5.1. Si tienes, por ejemplo, la versión 4.2.3 o posterior, bastará con que migres directamente a la 5.1.

Muy distinta será la historia si tienes una versión muy antigua. En este caso, deberás pasar por diferentes actualizaciones escalares para poder llegar a la última.

¿Por qué debemos actualizar Moodle escalarmente?

Moodle, como todo software, tiene versiones críticas, donde las novedades que aportan requieren cambios en su manera interna de trabajar. Estas mejoras, por lo general, afectan profundamente a la base de datos.

Para actualizar Moodle a la 5.1, las versiones críticas pasan por la: 1.6, 1.8, 1.9, 2.2, 2.7, 3.1, 3.6, 4.0 y 4.2. Es necesario instalar algunas o todas, dependiendo de la versión que tengas en tu servidor.

Para ejemplificarlo, tomemos el caso más extremo: una instalación de Moodle que tenga la versión 1.3, que datan del año 2004. (¡Hey! No te rías, existen versiones más antiguas en producción en la internet 😆)

En este caso es necesario migrar en este orden: 1.3 > 1.6 > 1.8 > 1.9 > 2.2 > 2.7 > 3.1 > 3.6 > 4.0 > 4.2 > 5.1. Son diez actualizaciones.

Con esto quiero decir que debes descargar todas esas versiones (excepto, por supuesto, la 1.3 donde estas) e ir instalando y migrando cada una de ellas; paso a paso, para garantizar una instalación sin problemas a la última versión.

En algunas de ellas cambiará hasta el motor de la base de datos: MyISAM a InnoDB. De ahí la importancia de la actualización escalar (no te preocupes que Moodle se encarga de hacer todo este trabajito adicional).

Ruta de actualización

A continuación te dejo un mapa de la ruta para actualizar Moodle hasta la versión 5.1

Si te encuentras en versiones intermedias, actualiza a la versión crítica más cercana. Por ejemplo: si estás en la versión 2.4, actualiza a la 2.7, de ahí a la 3.1, luego a la 3.6, 4.0, 4.2 y finaliza en la 5.1; no debes pasar por la 2.5, 2.6, 3.3, etc.

Como sé que algunos les puede confundir el gráfico, te lo dejo en forma de tabla para que no haya dudas. 😊

Preparativos para actualizar Moodle

Al momento de actualizar, hay dos tareas fundamentales: respaldar la base de datos y la carpeta Moodledata.

El Moodledata debería estar fuera de la carpeta de publicación del servidor. Dentro del archivo config.php está su ubicación exacta.

Te recomiendo guardes estos dos respaldos fuera del servidor, en un lugar seguro. Son el corazón de tu Moodle.

Respaldo de la base de datos

Hacer un respaldo de la base de datos es fundamental al actualizar Moodle.

En cada versión escalar, puedes detenerte y hacer otro respaldo, aunque en mi opinión, la más importante es la inicial. Si surge algún error, siempre puedes intentarlo desde el comienzo.

Existen muchas formas de hacer respaldo de bases de datos, la más fácil es desde el PhpMyAdmin de tu servidor.

Para esto, logueate con el usuario administrador de MySQL (usualmente root). Si usas CPanel te llevará directamente sin necesidad de loguearte.

Selecciona en el menú de la izquierda el nombre de la base de datos de tu Moodle. Luego vamos a la pestaña en la parte superior: Exportar y hacemos clic a Continuar para descargar la base de datos en formato SQL a nuestra computadora.

Descarga de las versiones de Moodle y requisitos necesarios

Descarga todas las versiones donde debas hacer escala desde aquí. La versión más reciente la obtienes en este vínculo.

Para actualizar Moodle a una versión superior, tu servidor debe cumplir con los requisitos necesarios en cuanto al software: PHP, MariaDB (MySQL) y Apache (o Nginx). Para saber los requisitos, en la página de descarga se muestran.

Los requisitos necesarios para tu versión actual, las posteriores, así como una lista de comprobación para conocer si tu servidor las cumple, los encuentras en tu Moodle en: Administración del sitio> Servidor >Entorno

Para instalar la versión 5.1, necesitarás al menos PHP 8.2 y MariaDB 10.11.0 (o MySQL 8.4). Con esto podrás instalar todas la versiones escalares también.

Modo mantenimiento

Pon tu sitio en Modo Mantenimiento al momento de arrancar con la actualización. Esto se hace yendo a: Administración del sitio> Servidor > Modo de mantenimiento. Haz clic a la casilla Habilitar y Guarda los cambios.

Clave de actualización

A partir de la versión 3 de Moodle, se implementó la contraseña de actualización (upgrade key). Esto busca evitar que al ejecutarse el update cualquier intruso pueda afectar su funcionamiento.

Para ello, edita el archivo config.php ubicado en la carpeta de Moodle y agrega este código:

$CFG->upgradekey = 'contraseña';

Coloca la clave entre las comillas de: contraseña. Usa una combinación de letras, números y caracteres especiales con al menos 8 dígitos.

Tu archivo config.php debería quedar parecido a este:

<?php  // Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype    = 'mariadb';
$CFG->dblibrary = 'native';
$CFG->dbhost    = 'localhost';
$CFG->dbname    = 'nombre_base_de_datos';
$CFG->dbuser    = 'usuario_base_de_datos';
$CFG->dbpass    = 'contraseña';
$CFG->prefix    = 'mdl_';
$CFG->dboptions = array (
  'dbpersist' => 0,
  'dbsocket' => 0,
);

$CFG->wwwroot   = 'https://dominio.com';
$CFG->dataroot  = '/directorio/moodledata/';
$CFG->admin     = 'admin';
$CFG->upgradekey = 'contraseña';

$CFG->directorypermissions = 0777;

$CFG->passwordsaltmain = '123456';

require_once(dirname(__FILE__) . '/lib/setup.php');

Servidor de prueba

Una práctica que te recomiendo, es replicar tu servidor Moodle en tu computadora o servidor de pruebas y verificar como se ejecutaría la actualización. Con esto, puedes probar posibles errores sin afectar el funcionamiento de tu sitio en producción y solo cuando todo funcione bien, aplicarlo.

Sabrás los errores que puedan ocurrir y buscar las soluciones. Créeme, esto algunas veces puede llevar días. 😬

Para ello te recomiendo leas este artículo, donde te enseño como instalar Moodle en tu computadora.

Usa los respaldos de la base de datos y Moodledata que realizaste de tu servidor en funcionamiento.

Pasos adicionales para actualizaciones a partir de Moodle 5.1 o superior

En Moodle 5.1, los archivos principales se movieron a la carpeta (directorio) public. Por ello, es necesario hacer algunos cambios del lado del servidor para que la actualización pueda ejecutarse con éxito.

En tu hosting debes configurar la carpeta de publicación de Moodle como: /public. Esto puedes lograrlo usando las herramientas de tu panel de control o accediendo como administrador a tu servidor.

Por ejemplo: si tienes CPanel, en las opciones de Dominio, edítalo y luego en el campo New Document Root, cambia el directorio de publicación a: /public

Dicho de otra forma: dominio.com/public. Donde dominio.com es el dominio donde está instalado el Moodle y /public es la nueva carpeta de publicación.

Por otra parte, si tienes acceso al servidor como Administrador, puedes cambiar el directorio de publicación de Moodle haciendo uso de los Hosts Virtuales, para que apunte al directorio public.

Si tienes Apache, quedaría algo así:

Alias /directoriomoodle /var/www/directoriomoodle/public
<Directory /var/www/directoriomoodle/public >
  Options Indexes FollowSymLinks
  AllowOverride All
  Require all granted
</Directory>

En Nginx:

root /var/www/moodle/public;

Los directorios como: /var/www pueden variar dependiendo del sistema operativo de tu servidor.

Debes reiniciar el servidor web después de estos cambios:

Para Apache:

service apache2 restart

Para Nginx:

service nginx restart

Moodle 5.1 recomienda instalar Composer en el servidor, esto no es obligatorio, al menos por ahora. Por lo que al momento de actualizar el Moodle puedes ver una advertencia como esta:

Puedes ignorarla sin problemas.

Si deseas instalarlo, como administrador de tu servidor usa estos comandos:

sudo apt-get install -y composer
cd  /var/www/directoriomoodle
sudo -u www-data composer install --no-dev --classmap-authoritative
sudo chown -R www-data:www-data vendor
sudo chmod -R 755 /var/www/directoriomoodle

Esto para servidores basados en Ubuntu.

Actualizando Moodle

Dirígete al directorio de publicación del servidor (por lo general /var/www o /public_html) y renombra la carpeta de tu Moodle actual, nombredecarpeta_old es una buena opción.

Si tu Moodle está volcado en el directorio de publicación sin carpeta principal que lo contenga: crea una nueva (con el nombre que te mencione en el párrafo anterior, por ejemplo) y mueve todos los archivos ahí.

Los archivos de instalación de Moodle no se reescriben, esto puede causar muchos problemas.

Sube el nuevo Moodle al servidor (el que descargaste) y descomprímelo en la carpeta de publicación; por defecto contienen una carpeta llamada moodle. Puedes renombrarla como quieras: dejarlo moodle o colocarle el nombre de tu anterior instalación; tuya es la decisión.

Si la instalación anterior estaba volcada directamente en la carpeta de publicación del servidor, debes replicar lo mismo con el nuevo Moodle.

Ahora copia el config.php de la instalación antigua en la nueva. Esto es un paso importante, ya que contiene información relevante para su funcionamiento.

Si tienes temas personalizados y son compatibles con la nueva versión, también cópialos en la nueva carpeta que está ubicada en: /carpetamoodle/theme.

También revisa si los plugins que tengas instalados son compatibles con el nuevo Moodle. Si no es así, desinstálalos y prueba a reinstalarlos después de la actualización. Esto un factor importante para decidir la migración, sobre todo si tu sitio depende de ellos.

Habilita las actualizaciones automáticas en: Administración del sitio > Servidor > Notificación de actualizaciones, para que Moodle te muestre las nuevas actualizaciones de plugins durante la migración si existieran (esto a partir de  la versión 2.4).

Ejecutando la actualización

Abre tu navegador web, y coloca en la barra de dirección: http://dominio.com/directoriomoodle/admin

Con esto se ejecutará la actualización de Moodle. En cada pantalla debes darle al botón Continuar ubicado en la parte inferior para poder avanzar.

Si colocaste la clave de actualización en el config.php, te la pedirá en cuanto quieras actualizar a una versión igual o superior a la 3.0.

Estas pantallas son referenciales y pueden variar.

En la primera pantalla te pide confirmar la actualización.

En la segunda, Moodle comprobará si tu servidor cumple con los requisitos para instalarla, de ser así, verás OK en verde en la columna Estado para cada ítem.

Es posible que te falte habilitar o deshabilitar alguna extensión del PHP si tuvieras algún error. Esto se puede hacer editando el archivo php.ini del servidor. La columna Nombre te servirá como referencia.

Se puede avanzar en la instalación, aunque algunas extensiones tengan el estado Revisar; esto se debe a que Moodle las tiene como recomendado en los requisitos, pero no imprescindible para avanzar.

Recomiendo atenderlas en lo posible.

Cuando te muestre el botón Continuar puedes seguir con la instalación.

La comprobación de plugins se realiza en la siguiente pantalla, tanto nativos de Moodle como los externos. Podrás instalar nuevas actualizaciones desde aquí si existieran. Si no son compatibles, Moodle los deshabilitará.

Cuando termines, dale clic al botón Actualizar base de datos Moodle ahora ubicado al final.

Ahora se procede a realizar la actualización propiamente dicha. Puede tardar un buen rato, no desesperes 😁, esto dependerá de la potencia de tu servidor.

Al final, si todo salió bien, verás las barras de éxito en verde. No olvides darle Continuar cuando concluya.

Para terminar la actualización, te pedirá llenes los datos necesarios en la nueva versión. Esto es sobre todo información necesaria en los nuevos módulos instalados.

Y listo, a disfrutar de tu nuevo Moodle, o debería decir a trabajar en él. 😛

Espero te sirva de ayuda este artículo. Si tienes dudas, déjalas en los comentarios.