Deploy Mayan EDMS

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

Deploy Mayan EDMS

/var/lib/postgresql/data

Just deployed

/data

/var/lib/mayan

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

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.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
Letta Code Remote
Run a Letta Code agent 24/7. No inbound ports, just deploy.

Letta
52