oksigenia/moodle · Moodle™ Docker image
Open sourceEducationInfrastructure and toolsMoodle™ in Docker, kept current with Moodle and PHP
It ships Moodle™'s code unmodified, with Apache and PHP set up the way Moodle recommends. The first start installs the site, and changing the tag upgrades Moodle and its plugins after backing up the database and the code. Every six hours a bot looks for new Moodle and PHP releases: when it finds one, the image is rebuilt, tested and published. Coming from Bitnami, you only change the image line.
A test site on Bitnami's Moodle™ 5.0.2, with a plugin installed
sed -i 's|bitnamilegacy/moodle:5.0.2|oksigenia/moodle:5.2|' compose.yaml
docker compose pull moodle && docker compose up -d moodle
Container campus-moodle-1 Recreated
Container campus-moodle-1 Started
docker compose logs -f moodle
…
[moodle] Updating Moodle code: 5.0.2 (Build: 20250811) -> 5.2.3 (Build: 20260914)
[moodle] Using the existing config.php (database settings come from it)
Before touching anything, a copy of the code and the database
[moodle] Backing up the current code to …/backups/20261003T164653Z/code.tar.gz
[moodle] Backing up the database to …/backups/20261003T164653Z/database.sql.gz
[moodle] Keeping add-on block_xp (blocks/xp -> public/blocks/xp)
[moodle] Upgrading the Moodle database
[moodle] Database upgrade finished
docker compose ps moodle
campus-moodle-1 oksigenia/moodle:5.2 Up 58 seconds (healthy)
The site, a minute later
campus-moodle-1
- Moodle™ 5.0.2 → 5.2.3
- Code and database backed up before anything else
- block_xp plugin kept
- Database upgraded
How it works
You start with a compose file
The first start installs the site. Coming from Bitnami, you only change the image line in your compose file.
It starts with a backup
Before touching anything it backs up the database and code, then updates the site with its plugins.
You update with the tag
Changing the tag really updates Moodle™. For a fix, you pull your branch's tag and recreate the container.
Who it is for
- Schools running their own Moodle™
- Universities and academies
- Sysadmins
- Former Bitnami users
What it does
A maintained image that installs and upgrades itself, backing up first, and comes signed. Coming from Bitnami, you change one line.
- Runs onDocker
- 2 languagesSpanish · English
- LicenceGPL-3.0
Updating is changing the tag
The tag really updates Moodle™, after a backup. A bot looks for new Moodle and PHP releases every six hours, and every week it is rebuilt with Debian's fixes.
Signed and scanned
Signed with cosign, with SBOM and provenance. Trivy blocks publication if there is a critical issue with a fix available.
From Bitnami in one line
Swap the image and you're done. Every build is tested against real Bitnami volumes.
Accessibility with one variable
It includes Oksigenia Access, switched off. With OKSIGENIA_ACCESS=on, your Moodle™ gets an accessibility panel.
amd64 · arm64
architectures
6 h
between checks for new releases
cosign
signed images
GPL-3.0
licence
Open source
Get started
curl -O https://raw.githubusercontent.com/OksigeniaSL/docker-moodle/main/compose.yaml
# edit MOODLE_URL and the passwords
docker compose up -dimage: oksigenia/moodle:5.2Standard
- Tested before release: clean install, upgrade with plugins and migration from Bitnami
- Apache and cron run without root
- SBOM and provenance in every image
- Docs in Spanish and English
Pricing
Free · open source
Licence: GPL-3.0
Rather we looked after it? We host and maintain it on a server of its own: Managed Moodle™ for anyone who teaches or trains
Links
Moodle™ Docker image
oksigenia/moodle
A maintained image that installs and upgrades itself, backing up first, and comes signed. Coming from Bitnami, you change one line.