---
title: "Deploy Mayan EDMS"
description: "Open-source document management with OCR, workflows and full-text search"
category: "Other"
url: https://railway.com/deploy/mayan-edms
---

# Deploy Mayan EDMS

Open-source document management with OCR, workflows and full-text search

**[Deploy Mayan EDMS on Railway](https://railway.com/template/mayan-edms)**

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

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

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### Mayan EDMS https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mayan-edms.png

- **Source:** https://github.com/aalfath/mayan-edms-railway-template
- **Health check:** /authentication/login/
- **Public domain:** Yes

## Documentation

# Deploy and Host Mayan EDMS on Railway

Mayan EDMS is a free, open-source document management system written in Python and Django. It stores scanned and digital documents, extracts their text with OCR, and lets you organize them with metadata, tags, cabinets and indexes, version them, sign them, and route them through workflows, from a web UI or a REST API.

## About Hosting Mayan EDMS

Mayan EDMS needs more than a web server. Its official image runs gunicorn for the web UI and API, several Celery worker pools for OCR, indexing and file parsing, and Celery beat for scheduled jobs. It needs a PostgreSQL database, a message broker and a lock manager, and a persistent directory for the documents and the secret key. This template runs the official all-in-one image, built from a GitHub repo, with Railway Postgres and Railway Redis (broker, results, locks and live events) and a volume on `/var/lib/mayan`. The worker pools are smaller than upstream's so the service fits a few GB of RAM. The first administrator is created with a generated password.

## Common Use Cases

* A searchable archive of scanned paper documents, invoices and contracts, with OCR and full-text search
* Document workflows for a small team: review, approval and retention policies
* A central document store that other tools fill and read through the REST API

## Dependencies for Mayan EDMS Hosting

* PostgreSQL (Railway Postgres)
* Redis (Railway Redis)

### Deployment Dependencies

* [Mayan EDMS documentation](https://docs.mayan-edms.com/)
* [Docker installation guide](https://docs.mayan-edms.com/chapters/docker/index.html)
* [Mayan EDMS on Docker Hub](https://hub.docker.com/r/mayanedms/mayanedms)
* [Template repo](https://github.com/aalfath/mayan-edms-railway-template)

### Implementation Details

* Log in as `admin` with the password from the Mayan EDMS service's `MAYAN_ADMIN_PASSWORD` variable (Variables tab). It's used once, on the first start; change the password later in Mayan's user menu. Unlike a plain Docker install, the password is never shown on the login page.
* The first start runs Mayan's setup and takes a few minutes. Later starts run its upgrade step, so a template update applies its migrations by itself.
* Documents, the secret key and caches live on the volume at `/var/lib/mayan`.
* Optional settings (SMTP for mailing, more OCR workers with `MAYAN_WORKER_B_CONCURRENCY`) are plain `MAYAN_*` variables; see the template repo's README.

## Why Deploy Mayan EDMS 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 Mayan EDMS 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

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/mayan-edms
