Alpine Chamilo¶
An unofficial container image for Chamilo LMS 3.x on Alpine Linux, Nginx and PHP-FPM 8.3, built on erseco/alpine-php-webserver. It runs as nobody, uses MariaDB, and ships the official Chamilo release archive unchanged, verified by SHA-256.
| Chamilo | 3.0.2 |
| PHP | 8.3 |
| Architectures | linux/amd64, linux/arm64 |
| Registries | Docker Hub erseco/alpine-chamilo, GHCR ghcr.io/erseco/alpine-chamilo |
| Tags | 3.0.2, 3.0, 3, latest |
Use 3.0.2 in production. The image refuses to start on a volume created by another Chamilo version (see operations), so 3.0, 3 and latest will stop at the next Chamilo release until upgrades are supported. 3.0.2 is rebuilt in place for base-image and Alpine updates.
Quick start¶
git clone https://github.com/erseco/alpine-chamilo.git
cd alpine-chamilo
cp .env.example .env # set distinct random passwords, the URL and the administrator
docker compose up -d --no-build
With CHAMILO_AUTO_INSTALL=true the container installs Chamilo on first start and becomes healthy when it is ready; log in at CHAMILO_URL as admin with CHAMILO_ADMIN_PASSWORD. Alternatively use Chamilo's own web installer.
The example stack binds HTTP to 127.0.0.1:8080 and does not publish MariaDB. Put a TLS-terminating reverse proxy in front for real use and set CHAMILO_TRUSTED_PROXIES.
What has been tested¶
On every change, CI (amd64) and local runs (arm64) cover: image contents and routing, the real web installer in a browser, the unattended installer, administrator login, course creation, document upload and download, SCORM 1.2 import and playback (including the SCORM API), restart and container recreation with read-only state, cold backup and restore into a new stack, installer lockdown, database-failure healthcheck, trusted-proxy header filtering, a real Nginx TLS proxy, and a derived image that adds a plugin. The eXeLearning plugin was also exercised end to end on a derived image.
Not tested: upgrades between Chamilo versions (blocked on purpose), Traefik or Cloudflare, Redis, scheduled tasks, LDAP, mail delivery, PostgreSQL.
More¶
- Installation
- Configuration
- Operations: volumes, backup, versions
- Plugins
- Security
- Development and testing
- Historical research notes
Chamilo is GPL-3.0-or-later, and so is this repository. Chamilo is a trademark of its owner; this image is not official.