Guía rápida de Instalación

Nota: Esta es una traducción de una página de la documentación en idioma Inglés (Docs), que se considera particularmente importante, y que en su versión original se actualiza frecuentemente. Por ello, se le recomienda que revise la página original en idioma inglés: Installation quick guide.

Esta página está dirigida a administradores con experiencia en la instalación de aplicaciones web y que tienen prisa por ponerla en marcha. De lo contrario, ver Instalación_de_moodle.

Requerimientos básicos

Necesitarás tener instalado:
- un servidor web (como por ejemplo Apache, Nginx, IIS);
- un servidor de base de datos (como por ejemplo PostgreSQL, MySQL, o MariaDB); y,
- PHP instalado y configurado.

Revisa además las notas de la versión [1] (en inglés) en la documentación de desarrollo (Dev Docs) para los detalles de las versiones soportadas.

Además de lo mencionado arriba, necesitarás:

instalar varias extensiones de PHP -- Moodle comprueba las extensiones instaladas al iniciar el proceso. Si falta alguna, te lo mostrará y podrás instalarla antes de seguir con el proceso de instalación.
configurar el Router de Moodle (importante a partir de la versión 5.1); y
asegurarse de tener un Agente de Transporte de Correo (MTA) funcionando, como por ejemplo Exim, Postfix o Sendmail; o tener acceso a un servidor de correo SMTP, como GMail.

Obtención de Moodle

Tiene dos opciones básicamente:

Descargar la versión que necesitas desde

https://download.moodle.org/

Obtener el código del repositorio Git (recomendado para desarrolladores y además hace las actualizaciones muy simples):

git clone -b MOODLE_502_STABLE git://git.moodle.org/moodle.git

Esto descarga una copia completa del repositorio Moodle y, a continuación, cambia a la rama estable 5.2

Nota: Descarga Moodle solamente de una de las fuentes de moodle.org. Otras versiones (p.ej. instaladores basados en paneles de control, repositorios de las distribuciones de Linux) pueden no funcionar correctamente, no ser actualizables o no obtener soporte.

Crear una base de datos

Usando el servidor de bases de datos elegido, crea una nueva base de datos. La codificación por defecto debe ser UTF-8 con el juego de caracteres mb4. Por ejemplo, usando MySQL:

mysql> CREATE USER 'moodleuser'@'localhost' IDENTIFIED BY 'la_contraseña_de_usuario_de_base_de_datos';
mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO 'usuario_de_la_base_de_datos'@'localhost';
mysql> FLUSH PRIVILEGES;

Nota: Es importante aplicar GRANT ON moodle.* como nombre de la base de datos, incluyendo '.*' y no solo el nombre de la base de datos. Recuerda la contraseña, ya que después será necesaria para la instalación de Moodle.

Crea el directorio de datos

Crea un directorio vacio para contener los ficheros de Moodle. NO debe estar en el directorio web público y debe tener los permisos de manera que el usuario del servidor web pueda escribir en él. Una ruta típica suele ser /var/www/. Además, convierte al usuario del servidor web en su propietario, o asigna al directorio permisos de escritura para 'todos' (0777).

Instalar el código de Moodle

Descomprime y mueve o copia el código de Moodle (obtenido anteriormente) de manera que pueda ser servido por el servidor web (p.ej. en distribuciones Linux basadas en Debian, instala el código en /var/www/html/moodle)
Comprueba los permisos y asegúrate de que el servidor web NO tiene permisos para escribir sobre ninguno de los ficheros en los directorios del código de Moodle (una causa muy común de sitios que han sido pirateados).
Si lo necesitas, configura tu servidor web para servir Moodle con la URL elegida.

Configura Moodle

En el directorio de Moodle, encuentra el fichero config-dist.php y cópialo sobre un nuevo fichero con el nombre config.php (pero lee el siguiente paso, 'Instala Moodle', primero antes de editarlo).
Edita config.php con tu editor favorito y cambia los valores apropiados que apuntan a tu sitio, directorios y base de datos. Nota: el proceso de instalación de Moodle creará el fichero config.php por tí si no existe pero asegúrate de establecer después los permisos apropiados

A partir de Moodle 5.1 en adelante, el archivo config.php y otros archivos sensibles (importantes, delicados, estratégicos) están almacenados afuera del directorio ´público public . Asegúrate que el servidor web esté configurado para servir solamente desde este directorio public . Para los detalles acerca de la configuración, ver la documentación para desarrolladores en idioma inglés en Code Restructure - Moodle Developer Resources.

Instalar Moodle

Dirígete a la URL de tu sitio Moodle con el navegador (la instalación se completará automáticamente) o ejecuta la versión de línea de comando (requiere la version cli de PHP) en:

/usr/bin/php /ruta/a/moodle/admin/cli/install.php

El proceso de instalación creará el fichero config.php y no se ejecutará si lo creaste en el paso anterior.

Tras la instalación, asegúrate de que los permisos son los correctos para los ficheros de Moodle (sin permisos de escritura para el servidor web), y moodledata, el directorio de datos de Moodle con permisos de escritura para el servidor web.

Añade la tarea programada (cron)

Necesitarás ejecutar una tarea programada cron que se ejecute cada minuto). La entrada en el cron en Linux será algo así:

* * * * * /usr/bin/php /ruta/a/moodle/admin/cli/cron.php >/dev/null

Donde * * * * * es la configuración del cron para ejecutarse cada minuto; /usr/bin/php es la ruta a php (puede ser diferente dependiendo de la instalación de PHP, incluso ejecutarse solo con el comando php sin ruta); y /ruta/a/moodle/admin/cli/cron.php >/dev/null es la ruta al comando cron de Moodle localizado en la carpeta /admin/cli/

Vea Cron para más opciones.

¡Felicidades!

Ya estás listo para usar tu sitio Moodle.

Si te encuentras con problemas, mira las FAQ Instalación, FAQ (en inglés) y visita Foro acerca de Instalación y actualización (en español) y Using Moodle Installation help forum (en inglés).

Ver También

Documentation