Skip to content

oksigenia/moodle · Moodle™ Docker image

Open sourceEducationInfrastructure and tools

Moodle™ 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.

bash — ~/campus

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

oksigenia/moodle:5.2 · healthy

  • Moodle™ 5.0.2 → 5.2.3
  • Code and database backed up before anything else
  • block_xp plugin kept
  • Database upgraded
A Bitnami Moodle™ moves to oksigenia/moodle by changing one line: backup first, plugin kept, upgraded to 5.2

How it works

  1. 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.

  2. It starts with a backup

    Before touching anything it backs up the database and code, then updates the site with its plugins.

  3. 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
  1. 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.

  2. Signed and scanned

    Signed with cosign, with SBOM and provenance. Trivy blocks publication if there is a critical issue with a fix available.

  3. From Bitnami in one line

    Swap the image and you're done. Every build is tested against real Bitnami volumes.

  4. 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

A new Moodle™
curl -O https://raw.githubusercontent.com/OksigeniaSL/docker-moodle/main/compose.yaml
# edit MOODLE_URL and the passwords
docker compose up -d
Coming from Bitnami, in your compose file
image: oksigenia/moodle:5.2

Licence · GPL-3.0

You can use, study, change and redistribute it, commercial projects included. If you distribute a modified version, you share it under the same licence.

Latest release

5.3.1 · 12 Nov 2026

Standard

  • 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

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.