---
title: "Deploy Chamilo"
description: "Open-source LMS for courses, SCORM, quizzes and certificates, on MariaDB"
category: "CMS"
url: https://railway.com/deploy/chamilo-1
---

# Deploy Chamilo

Open-source LMS for courses, SCORM, quizzes and certificates, on MariaDB

**[Deploy Chamilo on Railway](https://railway.com/template/chamilo-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/chamilo-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** CMS

## Template content

### Chamilo https://raw.githubusercontent.com/chamilo/chamilo-lms/v3.0.2/public/img/pwa-icons/icon-512.png

- **Source:** https://github.com/aalfath/chamilo-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

### MariaDB

- **Image:** mariadb:11.4.13@sha256:5e73baf8179b29f115101bb102763a47a017361f3e9792daccba6646c3ab1532
- **Start command:** `docker-entrypoint.sh mariadbd --datadir=/var/lib/mysql/data --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci`

## Documentation

# Deploy and Host Chamilo on Railway

Chamilo is an open-source learning management system (LMS) used by schools, universities and companies to run online courses. Teachers build courses with documents, learning paths, SCORM packages, exercises, assignments, forums and a gradebook, and learners follow them in the browser. It is licensed under GPLv3.

## About Hosting Chamilo

Chamilo is a PHP and Symfony application that needs a web server with PHP 8.3 or newer, a set of PHP extensions, a MariaDB or MySQL database and persistent storage for uploaded course files. This template builds the official Chamilo 3.0.2 release package on the official PHP Apache image and runs it next to MariaDB 11.4, each with its own volume. On the first start it runs Chamilo's own installer before the site goes public, so there is no open install wizard: the administrator account `admin` gets a generated password, which you find in the Chamilo service's `CHAMILO_ADMIN_PASSWORD` variable. The first start takes 2 to 3 minutes.

## Common Use Cases

* Run online or blended courses for a school, university or training center
* Deliver employee onboarding and compliance training with learning paths, quizzes and certificates
* Publish SCORM courses and track each learner's progress in the gradebook and reports

## Dependencies for Chamilo Hosting

* Chamilo 3.0.2 (PHP 8.4 with Apache), built from this template's GitHub repository
* MariaDB 11.4 (official image)

### Deployment Dependencies

* Chamilo source and releases: https://github.com/chamilo/chamilo-lms/releases
* Chamilo installation guide: https://github.com/chamilo/chamilo-lms#quick-install
* Template repository: https://github.com/aalfath/chamilo-railway-template
* MariaDB image: https://hub.docker.com/_/mariadb

### Implementation Details

* Log in at your Railway domain with the username `admin` and the password in the Chamilo service's `CHAMILO_ADMIN_PASSWORD` variable. The admin variables are used on the first start only, so change the password in Chamilo afterwards.
* Self-registration is off by default. Turn it on in Administration → Configuration settings → Registration if learners should sign up themselves.
* Email is not configured. Add your SMTP settings in Administration → Configuration settings → Mail.
* Custom domain: after adding it on Railway, change the portal URL in Administration → Configure access URLs.
* Updates: the Chamilo service builds from the GitHub repository, so Railway shows an update when a new Chamilo release is merged there. On the next start the template applies Chamilo's database migrations. Back up the MariaDB volume before a major update.

## Why Deploy Chamilo on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Chamilo on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Libredesk - Complete Setup](https://railway.com/deploy/libredesk-complete-setup) — Complete self-hosted omnichannel customer support desk.
- [Paperless-ngx](https://railway.com/deploy/paperless-ngx-3) — Paperless-ngx — document management with OCR and full-text search
- [Instatic CMS - Postgres](https://railway.com/deploy/instatic-cms-postgres) — Design, build and manage powerful static sites from state-of-the-art CMS

Open this page in a browser: https://railway.com/deploy/chamilo-1
