Instalar Moodle 5 desde Softaculous

Desde la versión 5.1, Moodle separa lo que se publica en la web del resto del código. Lo público va en una carpeta public y el código, la configuración y las librerías quedan un nivel por encima, donde ningún visitante llega. Softaculous lo resuelve así: instala el código en la carpeta superior a la del dominio y usa la carpeta del dominio como public.

Por eso, antes de instalar, la carpeta del dominio tiene que estar preparada para ello. Esta guía explica cómo hacerlo y qué comprobar antes.

Requisitos

Además, PHP tiene que tener activada la extensión sodium y max_input_vars en 5000 o más. Moodle 5.3 es una versión LTS, con actualizaciones de seguridad hasta octubre de 2029. Los requisitos completos están en las notas de Moodle 5.3.

Para saber qué base de datos tiene tu servidor, entra en tu hosting en el área de clientes y abre Ficha técnica. La tarjeta Base de datos y SSL muestra la versión:

• 8.0: es MySQL 8.0 y Moodle 5 no funciona con ella. Mira qué hacer si tu servidor tiene MySQL 8.0.
• 11.4 o superior: es MariaDB y admite cualquier versión de Moodle 5.

Fija PHP 8.3 u 8.4 para la cuenta o solo para la carpeta donde vaya Moodle. No uses PHP 8.5: no está entre las versiones que admite Moodle 5.3. En la misma pantalla de PHP activa sodium y sube max_input_vars a 5000 si tiene menos.

Preparar el subdominio

Lo más sencillo es instalar Moodle en un subdominio, como aula.tudominio.com, con una carpeta propia que termine en /public:

1. Accede a cPanel y abre Dominios.
2. Pulsa Create a New Domain y escribe el subdominio, por ejemplo aula.tudominio.com.
3. Desmarca Share document root si aparece marcada.
4. En Document Root / Raíz de documentos, escribe aula.tudominio.com/public. cPanel creará la carpeta /home/usuario/aula.tudominio.com/public.
5. Pulsa Submit / Enviar.
6. Espera a que el subdominio tenga su certificado SSL antes de instalar: Moodle se configura con la dirección https://.

Softaculous instalará el código en /home/usuario/aula.tudominio.com y la web se servirá desde public.

Si el subdominio ya existe, está vacío y su raíz es /home/usuario/aula.tudominio.com, cambia su raíz a aula.tudominio.com/public. Lo mismo vale para un dominio adicional con carpeta propia.

Instalar Moodle

1. En cPanel, abre Softaculous Apps Installer.
2. Busca Moodle, abre su ficha y pulsa Instalar.
3. El primer desplegable es el protocolo: elige https://, sin www.. El segundo es el dominio: elige el subdominio que has preparado.
4. Deja vacío el campo Directorio.
5. En Directorio de datos, Softaculous propone /home/usuario/moodledata. Si ya tienes otro Moodle en la cuenta, usa una carpeta distinta para cada instalación, por ejemplo /home/usuario/moodledata-aula: dos instalaciones no pueden compartirla.
6. Escribe el nombre del sitio, el usuario administrador, una contraseña única y el correo de administración.
7. Pulsa Instalar.

Al terminar, Softaculous muestra la dirección del aula y la de administración. Guarda esos datos en un gestor de contraseñas.

Error «Moodle files are already present»

Si Softaculous responde:

It seems that the Moodle files are already present at /home/usuario location. Hence you can not install Moodle on this domain. Please try to install lower version of Moodle on this domain.

la raíz del dominio está directamente en tu carpeta personal, por ejemplo /home/usuario/aula.tudominio.com. Softaculous quiere instalar el código en la carpeta superior, que en ese caso es /home/usuario, y como ya tiene archivos se niega. Cambiar el directorio de datos no lo soluciona: lo que hay que cambiar es la raíz del dominio, como se explica en preparar el subdominio.

El mensaje sugiere instalar una versión anterior, pero si tu servidor admite Moodle 5 no hace falta: el aula empezaría con una versión más antigua y tendrías que actualizarla después.

Moodle en el dominio principal

El dominio principal se sirve desde public_html, cuya carpeta superior es también tu carpeta personal, y cPanel no deja cambiar su raíz. Para Moodle 5, usa un subdominio como aula.tudominio.com o un dominio adicional con su propia carpeta terminada en /public. Si necesitas que el aula esté en el dominio principal, escríbenos antes de instalar y lo vemos contigo.

Si tu servidor tiene MySQL 8.0

Moodle 5 necesita MySQL 8.4 o MariaDB, así que en un servidor con MySQL 8.0 no se puede instalar. Escríbenos antes de instalar y vemos contigo la opción que encaja: trasladar tu cuenta a un servidor con MariaDB 11.4, o instalar Moodle 4.5. Moodle 4.5 es la versión LTS anterior y funciona con MySQL 8.0, pero solo recibe actualizaciones de seguridad hasta el 4 de octubre de 2027.

Después de instalar

• Entra en la dirección del aula y en la de administración, y comprueba que el certificado es válido.
• Programa el cron de Moodle cada minuto con una tarea cron. En Moodle 5 el script no está en public: la ruta es /home/usuario/aula.tudominio.com/admin/cli/cron.php. Usa el binario de la versión de PHP de tu Moodle, por ejemplo /opt/alt/php83/usr/bin/php.
• Configura el envío de correo por SMTP para que los avisos y las recuperaciones de contraseña lleguen.
• Programa copias de seguridad de los ficheros, del directorio de datos y de la base de datos. La copia de Moodle de un curso no sustituye una copia de toda la instalación.