Deploy and Host NodeBB on Railway

NodeBB is open-source community forum software built on Node.js. It has categories, topics, real-time replies and notifications over websockets, chat, groups, moderation tools and a plugin and theme system. It works well on phones and desktops, and you host it yourself, so your community's posts and members stay in your own database.

About Hosting NodeBB

This template runs two services. NodeBB 4.16.7 (the official image, pinned by digest) is served on a public Railway domain with a /sping health check. Postgres 18 stores all forum data on its own volume. On the first start, NodeBB is installed automatically from the deploy variables: the forum URL is set to the Railway domain and an admin account gets a generated password, so the web installer is never exposed. A volume on the NodeBB service keeps the configuration, uploaded files and built assets, so they survive redeploys. The first start builds the front-end assets, which takes about a minute.

Common Use Cases

A community forum for a product, open-source project, game or club
A customer support and knowledge-sharing board with categories and search
A private discussion space for a team or membership group

Dependencies for NodeBB Hosting

Postgres 18 (included, on a Railway volume)
An SMTP service if you want NodeBB to send email (optional)

Deployment Dependencies

Implementation Details

First login: sign in as admin with the NODEBB_ADMIN_PASSWORD value from the NodeBB service's Variables tab. Change it in your profile afterwards. Changing the variable later doesn't change the password.
Sign-ups: anyone can register, but new accounts wait for an administrator's approval (Admin > Manage > Registration Queue). NodeBB also queues the first posts of brand-new users for review (Admin > Manage > Post Queue). Change both under Admin > Settings > User and Admin > Settings > Post.
Email: NodeBB can't send email until you configure SMTP under Admin > Settings > Email. Password-reset emails need it.
Custom domain: after you add one in Railway, set NODEBB_URL to https:// plus your domain. The start script rewrites NodeBB's URL and database settings from the variables on every start.
Plugins: NodeBB's package.json lives on the volume, and the official entrypoint runs npm install from it on each start, so the plugin list carries over to new deployments.

Why Deploy NodeBB 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 NodeBB 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.