HUB
Sign inSign up
alpine-chamilo logo

erseco/alpine-chamilo

By erseco

•Updated 2 days ago

Unofficial Chamilo LMS 3.x on Alpine, Nginx and PHP-FPM 8.3 (amd64, arm64)

Image
0

406

erseco/alpine-chamilo repository overview

⁠alpine-chamilo

CI Release Docker Hub version Docker pulls Image size GHCR Docs License: GPL-3.0

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 unchanged, verified by SHA-256.

Chamilo3.0.2
Architectureslinux/amd64, linux/arm64
Imageserseco/alpine-chamilo:3.0.2⁠, ghcr.io/erseco/alpine-chamilo:3.0.2⁠

Tags: 3.0.2, 3.0, 3 and latest. 3.0.2 is rebuilt in place for base-image and Alpine updates and never changes Chamilo version. Use 3.0.2 in production: the image refuses to start on data created by a different Chamilo version until a tested upgrade procedure exists, so 3.0, 3 and latest will stop at the next Chamilo release.

⁠Quick start

cp .env.example .env   # set passwords, CHAMILO_URL and the administrator
docker compose up -d --no-build

CHAMILO_AUTO_INSTALL=true installs Chamilo on first start (this accepts Chamilo's GPLv3 license). The container turns healthy once the installation has finished; then log in as admin. The official web installer is also supported. Afterwards, mount state and configuration read-only. See installation⁠.

Back up the four volumes together: see operations⁠. To add plugins, build a derived image: see plugins⁠. For reverse proxies, set CHAMILO_TRUSTED_PROXIES: see configuration⁠ and security⁠.

⁠Configuration

With the example compose.yaml, set the CHAMILO_* and DB_PASSWORD variables in .env; add the PHP limits to the service's environment. Full reference: configuration⁠ and installation⁠.

VariableDefaultDescription
CHAMILO_AUTO_INSTALLfalsetrue installs Chamilo on first start (accepts the GPLv3 license). Needs the four variables below.
CHAMILO_URLPublic origin, for example https://chamilo.example.org. Required for the unattended installation.
CHAMILO_ADMIN_PASSWORDAdministrator password, at least 12 characters. Only read during the installation.
CHAMILO_ADMIN_EMAILAdministrator email, also the default sender.
DB_PASSWORDDatabase password. In compose.yaml it also creates the MariaDB user.
DB_HOST / DB_PORT / DB_NAME / DB_USERdb / 3306 / chamilo / chamiloDatabase connection for the unattended installation.
CHAMILO_LANGUAGEen_USPlatform and administrator language.
CHAMILO_ADMIN_USERNAMEadminAdministrator login.
CHAMILO_ADMIN_FIRSTNAME / CHAMILO_ADMIN_LASTNAMEChamilo / AdministratorAdministrator name.
CHAMILO_SITE_NAMEChamiloSite name.
CHAMILO_INSTITUTION / CHAMILO_INSTITUTION_URLChamilo / CHAMILO_URLOrganisation shown in the header.
CHAMILO_MAILER_DSNnull://nullSymfony Mailer DSN, for example smtp://user:[email protected]:587. The default sends no mail.
CHAMILO_MAILER_FROM_EMAIL / CHAMILO_MAILER_FROM_NAMEadmin email / ChamiloSender of outgoing mail.
CHAMILO_INSTALLER_ENABLEDfalsetrue opens the web installer until an installation is recorded.
CHAMILO_TRUSTED_PROXIESComma-separated IPs or CIDR ranges of reverse proxies whose X-Forwarded-* headers are trusted.
upload_max_filesize / post_max_size / client_max_body_size256MPHP and Nginx upload limits; raise all three together.
memory_limit512MPHP memory limit.

compose.yaml also reads CHAMILO_IMAGE, CHAMILO_PORT (published on 127.0.0.1), DB_ROOT_PASSWORD, and CHAMILO_STATE_MODE / CHAMILO_CONFIG_MODE (rw, or ro after installation). The example database is MariaDB 12.3 LTS with MARIADB_AUTO_UPGRADE=1, so a data directory from an older MariaDB is upgraded on start. Back up before changing the database version.

⁠Tested

Real browser tests on every change cover the web installer, the unattended installer, administrator login, course creation, document upload and download, SCORM import and playback, persistence across recreation with read-only state, backup and restore, installer lockdown, database-failure health, trusted proxies and TLS, and a derived plugin image. Upgrades between Chamilo versions, Traefik and Cloudflare are not tested. See development⁠.

Chamilo and this repository are GPL-3.0-or-later. Chamilo is a trademark of its owner; this is not an official image.

Tag summary

Content type

Image

Digest

sha256:add003d60…

Size

237.4 MB

Last updated

2 days ago

docker pull erseco/alpine-chamilo