Deploy Mayan EDMS
Open-source document management with OCR, workflows and full-text search
Just deployed
/var/lib/postgresql/data
Redis
Just deployed
/data
Mayan EDMS
Just deployed
/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
adminwith the password from the Mayan EDMS service'sMAYAN_ADMIN_PASSWORDvariable (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 plainMAYAN_*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
Redis
redis:8.2Mayan EDMS
aalfath/mayan-edms-railway-template