---
title: "Deploy Novu"
description: "Self-hosted notification infrastructure: in-app inbox, email, SMS, push"
category: "Other"
url: https://railway.com/deploy/novu-1
---

# Deploy Novu

Self-hosted notification infrastructure: in-app inbox, email, SMS, push

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

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

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

## Template content

### novu-ws https://raw.githubusercontent.com/novuhq/novu/v3.20.0/apps/dashboard/public/favicon-gradient.svg

- **Source:** https://github.com/aalfath/novu-railway-template
- **Health check:** /v1/health-check
- **Public domain:** Yes

### novu-worker https://raw.githubusercontent.com/novuhq/novu/v3.20.0/apps/dashboard/public/favicon-gradient.svg

- **Source:** https://github.com/aalfath/novu-railway-template
- **Health check:** /v1/health-check

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

- **Image:** redis:8.2.11@sha256:b0b01167ff47bc3868e56a967895a26be4230891a1f42a78ab61cdd227accc8d
- **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"`

### novu-api https://raw.githubusercontent.com/novuhq/novu/v3.20.0/apps/dashboard/public/favicon-gradient.svg

- **Source:** https://github.com/aalfath/novu-railway-template
- **Health check:** /v1/health-check
- **Public domain:** Yes

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

- **Image:** mongo:8.0.38@sha256:bdc216e9d5a6ec2cfdac789b5832fdab64cd32055f59885cae918a92de63c361
- **Start command:** `/bin/sh -c "export GLIBC_TUNABLES=glibc.pthread.rseq=1 && exec docker-entrypoint.sh mongod --ipv6 --bind_ip ::,0.0.0.0 --setParameter diagnosticDataCollectionEnabled=false"`

### novu-dashboard https://raw.githubusercontent.com/novuhq/novu/v3.20.0/apps/dashboard/public/favicon-gradient.svg

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

## Buckets

- **novu-storage**

## Documentation

# Deploy and Host Novu on Railway

Novu is open-source notification infrastructure. You define a workflow once, with in-app inbox, email, SMS, push and chat steps plus delays and digests, then trigger it from your backend with one API call. Novu handles provider credentials, subscriber preferences, retries and a ready-made in-app inbox.

## About Hosting Novu

Self-hosted Novu (Community Edition 3.20.0) runs four services from the official images: the API, a worker that processes the queues and delivers messages, a WebSocket server for the real-time inbox, and the web dashboard. It needs MongoDB for data, Redis for queues and cache, and S3-compatible storage for attachments. This template wires all of it over Railway's private network. It generates the JWT and encryption secrets, keeps MongoDB and Redis on volumes, uses a Railway bucket for attachments and gives the API, WebSocket server and dashboard public URLs with health checks. You fill in nothing at deploy time.

## Common Use Cases

* Send product notifications (in-app inbox, email, SMS, push, Slack and other chat) from one API call
* Add a real-time notification inbox to a web app with Novu's React or JavaScript SDK
* Batch frequent events into digests and let users manage their notification preferences

## Dependencies for Novu Hosting

* MongoDB (pinned official `mongo:8.0` image, on a volume)
* Redis (pinned official `redis:8.2` image, on a volume)
* A Railway bucket (S3-compatible) for attachments

### Deployment Dependencies

* Novu source and releases: https://github.com/novuhq/novu (release v3.20.0)
* Self-hosting docs: https://docs.novu.co/community/self-hosting-novu/overview
* Template repo (Dockerfiles, start scripts, changelog): https://github.com/aalfath/novu-railway-template

### Implementation Details

**After deploy**

1. Open the **novu-dashboard** URL and create your account. The first account becomes the owner of the instance.
2. Sign-up then closes: further registrations are refused, so nobody else can create an account on your instance. To add teammates, set `ALLOW_OPEN_REGISTRATION=true` on **novu-api**, redeploy, and remove it afterwards. To disable sign-up entirely, set `DISABLE_USER_REGISTRATION=true`.
3. Copy your secret key under **API Keys**, connect your providers under **Integrations**, and trigger a workflow. In the SDKs set `backendUrl` to the **novu-api** URL and `socketUrl` to the **novu-ws** URL.

**Secrets:** `JWT_SECRET`, `STORE_ENCRYPTION_KEY` (32 characters, encrypts provider credentials) and `NOVU_SECRET_KEY` are generated on **novu-api**. The worker and WebSocket server reference them. Never change `STORE_ENCRYPTION_KEY` after setup, or stored provider credentials can no longer be read.

**Updates:** every Novu service builds from the template repo, where each image is pinned by version and digest. When a new Novu version is merged there, Railway shows you an update notice and you choose when to apply it. Read `CHANGELOG.md` in the repo first, and back up MongoDB before a major upgrade.

**Optional settings:** self-hosted mode, pool sizes and telemetry defaults live in each service's `start.sh` as overridable defaults. Set any of them as a service variable to change it.

## Why Deploy Novu 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 Novu 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/novu-1
