docker-moodle

A Dockerfile that installs the latest Moodle, Apache and PHP. This uses the official MySQL images from Docker Hub.

Setup

git clone https://github.com/up2university/docker-moodle.git
cd docker-moodle

Populate envs/ (based on the contents of envs-templates/) to specify local details, especially common.env:

MYSQL_ROOT_PASSWORD=MyMy5QLPas$word
MOODLE_PASSWORD=MyM00Dl3Pas$word
VIRTUAL_HOST=localhost

and fill out other .env files from /envs-templates for automatic configuration of any needed tools/integrations.

Create a directory ./data/ to hold persistent data.

Usage

To spawn a new instance of Moodle:

docker-compose build
docker-compose up

and, in a separate terminal, once the Docker containers are running,

docker-compose exec moodle /configure.sh
docker-compose exec mysql /configure.sh

to configure from the /envs/ directory.

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

https://localhost/

Thanks to sergiogomez, eugeneware and ricardoamaro for their Dockerfiles.

SSL certificates

By default a self-signed certificate is created. It is enough for local instances.

Setting up a public instance, edit envs/common.env to includes

CURL_OPTS='-k'

and do the following:

docker-compose exec moodle bash

rm /etc/apache2/sites-enabled/default-ssl.conf
rm -r /etc/letsencrypt/live
/certbot-setup.sh
exit

docker-compose restart moodle

To renew the certificate later just run the /certbot-setup.sh within the container.

Build images

Build the app and push images to Docker Hub:

branch=$(git rev-parse --abbrev-ref HEAD)
docker build -t up2university/moodle-mysql:${branch} mysql
docker push up2university/moodle-mysql:${branch}
docker build -t up2university/moodle:${branch} moodle
docker push up2university/moodle:${branch}

Deployment

For the first time put .env file on the host and add DOCKER_TAG=value, specifying which git branch or commit should be deployed on the host. Docker images are created for both branches and particular commits, for instance:

• DOCKER_TAG=develop
• DOCKER_TAG=commit-985d87ac2b69c119058a5d290c250e09ed79962b

On deploy upload docker-compose-deploy.yml to the host and run the following there:

docker-compose -f docker-compose-deploy.yml pull
docker-compose -f docker-compose-deploy.yml up -d

Known issues

• Sometimes after deployments, changes don’t work until one opens the settings page for particular component and then save it (without changing anything). Spotted for missing CERNBox in the repository list.