---
title: "Deploy MediaCMS"
description: "Self-hosted video portal: uploads, transcoding, HLS, Postgres and Redis"
category: "CMS"
url: https://railway.com/deploy/mediacms-1
---

# Deploy MediaCMS

Self-hosted video portal: uploads, transcoding, HLS, Postgres and Redis

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

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

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

## 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"`

### MediaCMS https://raw.githubusercontent.com/mediacms-io/mediacms/v9.6.1/static/favicons/android-chrome-512x512.png

- **Source:** https://github.com/aalfath/mediacms-railway-template
- **Health check:** /accounts/login/
- **Public domain:** Yes

## Documentation

# Deploy and Host MediaCMS on Railway

MediaCMS is an open-source video and media CMS built with Django and React. It hosts videos, audio, images and PDFs with automatic transcoding to several resolutions, HLS adaptive streaming, playlists, categories, tags, comments, subtitles, user roles and a REST API, so you can run your own video portal without a third-party host.

## About Hosting MediaCMS

MediaCMS needs a web server, background workers for transcoding and thumbnails, PostgreSQL, Redis and disk space for uploads. This template runs MediaCMS 9.6.1 from a GitHub repo that pins the official image by digest. One service runs nginx, gunicorn, Celery beat and the short- and long-task workers under supervisord, so the app and the transcoders share one media volume. Railway Postgres and Railway Redis are wired in over the private network. Migrations and the first admin account run on the first start. The admin password and Django secret key are generated, and public sign-up starts closed. The deploy form has no required fields.

## Common Use Cases

* A private or public video portal for a company, school or community
* Internal training and screen recordings with access control
* A self-hosted media library with HLS streaming and embeddable players

## Dependencies for MediaCMS Hosting

* PostgreSQL (Railway Postgres)
* Redis (Railway Redis, cache and Celery queues)

### Deployment Dependencies

* MediaCMS source and docs: https://github.com/mediacms-io/mediacms
* Release 9.6.1: https://github.com/mediacms-io/mediacms/releases/tag/v9.6.1
* Template repo: https://github.com/aalfath/mediacms-railway-template

### Implementation Details

After the deploy, sign in at your Railway domain with the username `admin` and the generated `ADMIN_PASSWORD` from the MediaCMS service's Variables tab, then change the password in MediaCMS. Uploads, encodings and HLS files live on the volume at `/home/mediacms.io/mediacms/media_files`. Optional settings on the MediaCMS service: `USERS_CAN_SELF_REGISTER=True` opens sign-up, `GLOBAL_LOGIN_REQUIRED=True` makes the whole portal private, `EMAIL_HOST`, `EMAIL_PORT`, `EMAIL_HOST_USER`, `EMAIL_HOST_PASSWORD` and `DEFAULT_FROM_EMAIL` enable mail, and `CELERY_LONG_CONCURRENCY` (default 1) sets parallel transcodes. If you add a custom domain, set `FRONTEND_HOST` to `https://YOUR-DOMAIN`. Video transcoding is CPU-heavy, so give the service enough CPU for your upload volume.

## Why Deploy MediaCMS 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 MediaCMS 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/mediacms-1
