🎓 Cómo instalar Moodle 5.1+ de forma segura (Guía paso a paso)
¡Hola! Si estás intentando instalar la nueva versión de Moodle (5.1 o superior) y te has encontrado con errores de directorio o alertas de rutas incorrectas, no te preocupes. A partir de octubre de 2025, Moodle implementó un nuevo y estricto estándar de seguridad que cambia la forma en que se estructuran sus archivos.
🚨 ¿Por qué ya no es tan simple como antes?
Anteriormente, podías instalar Moodle en una subcarpeta de tu sitio, como [su-dominio. com]/academia. Sin embargo, Moodle 5.1 ahora exige que su «corazón» (los archivos más sensibles) esté oculto, y que solo una subcarpeta específica llamada public sea accesible desde internet.
Si intentamos hacer la instalación de forma tradicional, Softaculous arrojará errores. Además, si solo creamos un subdominio sin ajustar las rutas, los archivos vitales de Moodle (como el archivo de configuración) terminarán guardándose en la raíz principal de tu cuenta de hosting (ej. /home/usuario/), lo cual «rompe» la instalación y genera errores fatales de lectura.
✅ La solución: Subdominio con ruta personalizada
Para que todo funcione a la perfección, debemos crear un subdominio, hacer un pequeño ajuste en su carpeta destino y preparar el terreno antes de usar Softaculous. Sigue estos pasos al pie de la letra:
- Crea el subdominio y modifica su ruta: Ingresa a tu panel de control (cPanel o DirectAdmin) y ve a la sección de «Subdominios» o «Dominios». Al escribir el nombre de tu subdominio (por ejemplo, «academia»), el panel te sugerirá una «Ruta de documento» (Document Root) por defecto, que suele ser algo como
/academia.
¡Atención aquí! Debes editar manualmente esa ruta y agregarle/publical final.
👉 Ruta por defecto (Incorrecta):/academia
👉 Ruta corregida (Correcta):/academia/public
Una vez corregida la ruta, haz clic en crear. - Borra la carpeta «public» temporalmente: Ahora, dirígete al «Administrador de Archivos» de tu panel. Entra a la carpeta base de tu nuevo subdominio (ej.
/academia). Verás que adentro el panel creó automáticamente una carpeta llamadapublic. Debes eliminar esa carpetapublic. Esto es un paso vital porque el instalador de Moodle necesita tener la libertad de crear esa carpeta por sí mismo; si ya existe, puede generar conflictos. - Instala Moodle desde Softaculous: Ve a Softaculous, busca Moodle y presiona «Instalar».
– En el campo Seleccione Dominio: Elige el subdominio que acabas de crear (ej. academia.[su-dominio.com]).
– En el campo Directorio: ¡Asegúrate de borrar todo! Este campo debe quedar completamente en blanco.
Completa el resto de los datos (usuario administrador, contraseña, etc.) y haz clic en «Instalar». Al hacerlo con este método, Softaculous colocará los archivos web visibles dentro de la carpeta public y los archivos sensibles quedarán un nivel más arriba de forma automática, manteniéndolos totalmente protegidos y funcionando sin errores.
🤝 ¿Necesitas ayuda adicional?
Sabemos que este nuevo requisito de Moodle añade un par de pasos extra que pueden ser confusos. Si te enredas en alguna parte del proceso o el error de «Failed opening required» persiste, ¡no dudes en abrir un ticket de soporte desde tu área de cliente! Nuestro equipo técnico revisará las rutas por ti y dejará tu aula virtual funcionando al 100%.