---
title: "Deploy Revolt"
description: "Open-source Discord-style chat (Stoat): servers, channels, DMs, files"
category: "Other"
url: https://railway.com/deploy/revolt
---

# Deploy Revolt

Open-source Discord-style chat (Stoat): servers, channels, DMs, files

**[Deploy Revolt on Railway](https://railway.com/template/revolt)**

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

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

## Template content

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

### RabbitMQ https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/rabbitmq.png

- **Source:** https://github.com/aalfath/revolt-railway-template

### Revolt https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/revolt.png

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

### MongoDB https://devicons.railway.app/i/mongodb.svg

- **Image:** ghcr.io/railwayapp-templates/mongo-ha/mongo:8.0
- **Start command:** `docker-entrypoint.sh mongod --ipv6 --bind_ip ::,0.0.0.0 --setParameter diagnosticDataCollectionEnabled=false`

## Buckets

- **Bucket**

## Documentation

# Deploy and Host Revolt on Railway

Revolt, now developed under the name Stoat, is an open-source chat platform: users join servers with text channels, roles and permissions, and talk in direct messages and groups. Files, link previews, custom emoji and bots are included. Its web app feels much like Discord, but you run the whole stack yourself.

## About Hosting Revolt

Revolt is several Rust services (API, events WebSocket, file server, link proxy, scheduled tasks, push notifications), a web client, MongoDB, Redis, RabbitMQ and S3-compatible storage. This template runs every Revolt process and the web client in one container behind Caddy, so they share one public domain (`/api`, `/ws`, `/autumn`, `/january`), as the official self-hosted setup does. MongoDB and Redis are Railway databases, uploads go to a Railway Bucket, and RabbitMQ builds from the template repo. The public URL, the file-encryption key and the Web Push keys are set up automatically, so the template asks for nothing at deploy time.

## Common Use Cases

* A private chat server for a community, club, gaming group or open-source project
* Team chat with servers, channels and roles, without a hosted service
* A Discord-style chat whose data and uploaded files stay in your own database and bucket

## Dependencies for Revolt Hosting

* MongoDB (Railway MongoDB) for accounts, servers and messages
* Redis (Railway Redis) for events and presence
* RabbitMQ for internal messaging (built from the template repo)
* A Railway Bucket for uploaded files

### Deployment Dependencies

* Template repo: [aalfath/revolt-railway-template](https://github.com/aalfath/revolt-railway-template)
* Upstream self-hosting guide: [revoltchat/self-hosted](https://github.com/revoltchat/self-hosted)
* Backend releases: [stoatchat/stoatchat](https://github.com/stoatchat/stoatchat/releases) (v0.16.4); web client: [stoatchat/for-web](https://github.com/stoatchat/for-web/releases) (v0.17.0)

### Implementation Details

Open the Railway domain and choose **Create account**. Registration is open and there's no admin account. To make the instance invite-only, set `REVOLT_INVITE_ONLY=true` on the Revolt service (invite codes are documents in the `invites` collection of the `revolt` database). For a custom domain, add it to the Revolt service and set `REVOLT_PUBLIC_URL=https://chat.YOUR-DOMAIN`. Email verification is off until you add SMTP settings, for example `REVOLT__API__SMTP__HOST`, `REVOLT__API__SMTP__USERNAME`, `REVOLT__API__SMTP__PASSWORD` and `REVOLT__API__SMTP__FROM_ADDRESS`.

Voice and video calls aren't included: they need LiveKit with a UDP port range, which Railway doesn't offer. Don't change `REVOLT_SECRET` after the first upload, or stored files can no longer be decrypted.

## Why Deploy Revolt 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 Revolt 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)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/revolt
