ellakcy/moodle repository overview

⁠docker-moodle

A Docker image that installs and runs the latest Moodle stable, with external MySQL, Mariadb or Postgresql Database and automated installation with a default predefined administrator user. Also all the images are availalbe via docker hub⁠.

⁠Buidling

Buidling the required images using this repo is a liitle laborious and the whole process is described in the CONTRIBUTING.md file.

⁠Available Images

All available images are listed in: https://hub.docker.com/r/ellakcy/moodle/tags?page=1&ordering=-name⁠

Each flavor is seperates by database support, version and either if is it based on apache, or alpine via fpm. To be more specific:

The ^VERSION^ is a 2-3 digit number the first digit follows the major version and the rest of them follow the minor version for example the mulitbase_apache_39 runs the moodle 3.9 whilst mulitbase_apache_310 runs the moodle 3.10 .

Also for the latest moodle version we also ship the following images:

Whilst for the most recent moodle lts we ship:

All images are shipped with php 7.4 .

⁠PHP 8.0 images

Default php is 7.4 whereas images with php 8.0 are shipped as well for moodle versions 3.11, 4.0 and 4.11 php is shipped as well:

For php 7.4 images use the following

⁠Supported Database Versions:

The images support the following version for each database:

• Postgresql: 11 or earlier
• Mysql: 5.7
• Mariadb: 10.2

⁠Build Cycle and build versions

We aim to deliver freshly images on weekly basis. Each build image is tagged with the build date in a format _YmdHi, without build date is the latest build, for example the image mysql_maria_apache_latest is the latest built image whilst mysql_maria_apache_latest_202108112012 is the image built at 2021-08-11 20:12. At docker hub you can look at tags⁠ section for the latest or older builds.

⁠Run

⁠Running images manually

⁠Apache based solutions

To spawn a new instance of Moodle:

• ... using MySQL:

  docker run -d --name DB -e MYSQL_DATABASE=moodle -e MYSQL_RANDOM_ROOT_PASSWORD=yes -e MYSQL_ONETIME_PASSWORD=yes -e MYSQL_USER=^a database user^ -e MYSQL_PASSWORD=^a database password^ mysql:5.7
  docker run -d -P --name moodle --link DB:DB -e MOODLE_DB_HOST=DB -e MOODLE_URL=http://0.0.0.0:8080 -p 8080:80 ellakcy/moodle:mysql_maria_apache_^VERSION^
  

  Copy

  ** NOTICE ** For now due to the way that mysql authenticates its users, is working with vesrsion 5.7 version of mysql and earlier

• ... using MariaDB:

  docker run -d --name DB -e MYSQL_DATABASE=^a database name^ -e MYSQL_RANDOM_ROOT_PASSWORD=yes -e MYSQL_ONETIME_PASSWORD=yes -e MYSQL_USER=^a database user^ -e MYSQL_PASSWORD=^a database password^ mariadb:10.2
  docker run -d -P --name moodle --link DB:DB -e MOODLE_DB_HOST=DB -e MOODLE_URL=http://0.0.0.0:8080 -e MOODLE_DB_TYPE="mariadb" -p 8080:80 ellakcy/moodle:mysql_maria_apache_^VERSION^
  

  Copy

  ** NOTICE ** Please use Mariadb 10.2 and earlier for the same reasons as mysql one.

• ... using PostgreSQL:

  docker run --name=DB -e POSTGRES_USER=^a database user^ -e POSTGRES_PASSWORD=^a database password^ -e POSTGRES_DB=^a database name^ -d postgres
  docker run -d -P --name moodle --link DB:DB -e MOODLE_DB_HOST=DB -e MOODLE_URL=http://0.0.0.0:8080 -e MOODLE_DB_TYPE="pgsql" -p 8080:80 ellakcy/moodle:postgresql_apache_^VERSION^
  

  Copy

Then you can visit the following URL in a browser to get started:

http://0.0.0.0:8080

⁠Alpine with Fpm based solutions

For fpm solutions is recomended to use docker-compose. For production use is reccomended the to use the repo https://github.com/ellakcy/moodle-compose⁠ .

⁠Enviromental variables

Also you can use the following extra enviromental variables (using -e option on docker run command):

⁠Enviromental Variables for Default user settings:

A default user is generated during installation. Please provide different credentials during installation.

⁠Enviromental Variables for Database settings:

⁠Enviromental Variables for Email settings

⁠Enviromental Variables for reverse proxy

⁠Volumes

For now you can use the following volumes:

• /var/moodledata In order to get all the stored data.
• /var/www/html Containing the moodle source code. This is used by nginx as well.

⁠Using SSL Reverse proxy

⁠Via nginx

In case you want to use the nginx as reverse http proxy is recommended to provide the following settings:

server {
  listen  449 ssl;
  server_name  ^your_domain^;

  ssl_certificate     ^path_to_cert^;
  ssl_certificate_key ^path_to_key^;
  ssl_protocols       TLSv1 TLSv1.1 TLSv1.2;
  ssl_ciphers         HIGH:!aNULL:!MD5;

  location / {
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';

        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;

        # In case or running another port please replace the value bellow.
        proxy_pass http://^local_url_and_port^;
  }
}

Where:

• ^your_domain^: The domain that the moodle is available. Keep in mind that this value is the same in the MOODLE_URL enviromental variable.
• ^local_url_and_port^: Url that the reverse proxy will forward the requests.
• ^path_to_cert^,^path_to_key^: The certificate and its key.

As you can see the reverse proxy DOES NOT provide the http Host header according to this⁠ issue.

Also keep in mind to set the following docker enviromental variables MOODLE_REVERSE_LB and MOODLE_SSL into true as well.

⁠Caveats

⁠Moodle related

The following aren't handled, considered, or need work:

• moodle cronjob (should be called from cron container)
• log handling (stdout?)
• email (does it even send?)

⁠Docker related

Also in case of an error that mentions:

UnixHTTPConnectionPool(host='localhost', port=None): Read timed out. (read timeout=60)

Export the following enviromental variables:

export DOCKER_CLIENT_TIMEOUT=120
export COMPOSE_HTTP_TIMEOUT=120

⁠Credits

This is a fork of jmhardison/docker-moodle⁠.