venatorfox/moodle repository overview

Supported tags and respective Dockerfile links

• MOODLE_38_STABLE, latest (MOODLE_38_STABLE/Dockerfile)⁠
• MOODLE_37_STABLE (MOODLE_37_STABLE/Dockerfile)⁠
• 3.4.1 (3.4.1/Dockerfile)⁠
• 3.3.4 (3.3.4/Dockerfile)⁠
• 3.0.10 (3.0.10/Dockerfile)⁠

Now with plugin support via docker -e!

⁠How to use this image

Example: To startup a super basic, unconfigured local install with default values, no ssl.

Create a docker network moodle-network

docker network create moodle-network

Start a postgres server instance from the official postgres repository

| If mysql is desired, use the 2nd example further below.

docker run --rm -d --name moodle-postgres \
           --network moodle-network \
           --env POSTGRES_USER=moodle \
           --env POSTGRES_PASSWORD=moodle \
           --env POSTGRES_DB=moodle \
           postgres:11.4

Then start a venatorfox/moodle instance, expose port 80.

docker run --rm -d --name some-moodle \
           --network moodle-network \
           --env MOODLE_WWWROOT=http://localhost \
           --publish 80:80 \
           venatorfox/moodle:MOODLE_38_STABLE

⁠MySQL Variant

Example: Same thing as above, but for mySQL instead of Postgres. Postgres is however recommended as per Moodle docs⁠. Please note that brand new installs of MySQL 8 will require a workaround⁠ to avoid authentication issues. Upgrades from MySQL 5 to 8 carries over the workaround.

Create a docker network moodle-network

docker network create moodle-network

docker run --rm -d --name moodle-mysql \
           --network moodle-network \
           --env MYSQL_ROOT_PASSWORD=moodle \
           --env MYSQL_USER=moodle \
           --env MYSQL_PASSWORD=moodle -env \
           --MYSQL_DATABASE=moodle \
           mysql:5.7.27

Then start a venatorfox/moodle instance, change dbtype settings, expose port 80.

docker run --rm -d --name some-moodle \
           --network moodle-network \
           --env MOODLE_WWWROOT=http://localhost \
           --env MOODLE_DBTYPE=mysqli \
           --env MOODLE_DBHOST=moodle-mysql \
           --env MOODLE_DBPORT=3306 \
           --publish 80:80 \
           venatorfox/moodle:MOODLE_38_STABLE

If this is a new db install, grab some covfefe and wait until the webserver starts (indicated by [services.d] done in the log). Visit the site at Visit the site at http://localhost⁠, default username (if nothing was configured via --env) is "admin" and password "password". #superSecure

See below for available runtime environment variables for a more specific configuration, such as plugin installation.

Volumes should be mounted for the moodledata and the database for persistant storage. The moodledata directory is located at /var/moodledata. Please remember to do this so no data loss occurs! The container should be pulled and re-created as version updates from Moodle occur often.

⁠Runtime Environment Variables

All customizations can be done via the following environment variables. It is recommended to set them properly and not use default values. (Unless you want limits at 1M & no SSL, with your admin password being password (Can you not, kthx)).

Ephemeral variables can be changed on existing installations via container rebuild as they are in the moodle container and have no relation to the database.

⁠More Complex Examples

Some more complex (ie. with SSL termination, Plugins, etc...) setup examples are located in the README.md within the examples directory⁠.

⁠Maintenance

Please Create an issue⁠ if needed.