---
title: "Deploy NodeBB"
description: "Community forum with real-time replies; admin created on deploy"
category: "Other"
url: https://railway.com/deploy/nodebb-1
---

# Deploy NodeBB

Community forum with real-time replies; admin created on deploy

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

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

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

## Template content

### NodeBB https://cdn.jsdelivr.net/gh/selfhst/icons/svg/nodebb.svg

- **Image:** ghcr.io/nodebb/nodebb:4.16.7@sha256:0f011ebeba66740a98254aaa7d10159c4bbcb1b3462913492bf1079644ad9dac
- **Start command:** `/bin/sh -c "echo IyEvYmluL2Jhc2gKIyBOb2RlQkIgb24gUmFpbHdheTogb25lIHZvbHVtZSBob2xkcyBjb25maWcsIHVwbG9hZHMgYW5kIGJ1aWx0IGFzc2V0cy4gVGhlIGZpcnN0CiMgc3RhcnQgcnVucyBgbm9kZWJiIHNldHVwYCBmcm9tIHRoZSBOT0RFQkJfKiB2YXJpYWJsZXMgKHRoZSB3ZWIgaW5zdGFsbGVyIG5ldmVyCiMgb3BlbnMpLCB0aGVuIHRoZSBvZmZpY2lhbCBlbnRyeXBvaW50IHJ1bnMgYXMgdGhlIHVucHJpdmlsZWdlZCBub2RlYmIgdXNlci4Kc2V0IC1ldQpBUFA9L3Vzci9zcmMvYXBwCkQ9IiR7UkFJTFdBWV9WT0xVTUVfTU9VTlRfUEFUSDotL2RhdGF9IgpleHBvcnQgQ09ORklHX0RJUj0iJEQvY29uZmlnIiBDT05GSUc9IiREL2NvbmZpZy9jb25maWcuanNvbiIKZXhwb3J0IE5PREVCQl9EQj1wb3N0Z3JlcyBOT0RFQkJfUE9SVD0iJHtQT1JUOi00NTY3fSIKZXhwb3J0IE5PREVCQl9BRE1JTl9VU0VSTkFNRT0iJHtOT0RFQkJfQURNSU5fVVNFUk5BTUU6LWFkbWlufSIKZXhwb3J0IEhPTUU9IiRBUFAiIFVTRVI9bm9kZWJiCjogIiR7Tk9ERUJCX1VSTDo/Tk9ERUJCX1VSTCBtdXN0IGJlIHNldH0iCkFTPSJzZXRwcml2IC0tcmV1aWQ9MTAwMSAtLXJlZ2lkPTEwMDEgLS1pbml0LWdyb3VwcyIKbG9nKCkgeyBlY2hvICJbcmFpbHdheV0gJCoiOyB9Cgpta2RpciAtcCAiJENPTkZJR19ESVIiICIkRC91cGxvYWRzIiAiJEQvYnVpbGQiCnJtIC1yZiAiJEQvbG9zdCtmb3VuZCIKaWYgWyAhIC1MICIkQVBQL3B1YmxpYy91cGxvYWRzIiBdOyB0aGVuCiAgWyAtZSAiJEQvdXBsb2Fkcy8uc2VlZGVkIiBdIHx8IHsgY3AgLWEgIiRBUFAvcHVibGljL3VwbG9hZHMvLiIgIiREL3VwbG9hZHMvIiAyPi9kZXYvbnVsbCB8fCB0cnVlOyB0b3VjaCAiJEQvdXBsb2Fkcy8uc2VlZGVkIjsgfQogIHJtIC1yZiAiJEFQUC9wdWJsaWMvdXBsb2FkcyIKZmkKWyAtTCAiJEFQUC9idWlsZCIgXSB8fCBybSAtcmYgIiRBUFAvYnVpbGQiCmxuIC1zZm4gIiREL3VwbG9hZHMiICIkQVBQL3B1YmxpYy91cGxvYWRzIgpsbiAtc2ZuICIkRC9idWlsZCIgIiRBUFAvYnVpbGQiCmZpbmQgIiREIiBcISAtdXNlciAxMDAxIC1leGVjIGNob3duIC1oIDEwMDE6MTAwMSB7fSArCgppPTAKdW50aWwgbm9kZSAtZSAnY29uc3Qgcz1yZXF1aXJlKCJuZXQiKS5jb25uZWN0KCtwcm9jZXNzLmVudi5OT0RFQkJfREJfUE9SVHx8NTQzMixwcm9jZXNzLmVudi5OT0RFQkJfREJfSE9TVCk7cy5vbigiY29ubmVjdCIsKCk9PnByb2Nlc3MuZXhpdCgwKSk7cy5vbigiZXJyb3IiLCgpPT5wcm9jZXNzLmV4aXQoMSkpO3NldFRpbWVvdXQoKCk9PnByb2Nlc3MuZXhpdCgxKSwzMDAwKSc7IGRvCiAgaT0kKChpKzEpKTsgWyAiJGkiIC1ndCA2MCBdICYmIHsgbG9nICJQb3N0Z3JlcyBpcyBub3QgcmVhY2hhYmxlIjsgZXhpdCAxOyB9CiAgbG9nICJ3YWl0aW5nIGZvciBQb3N0Z3Jlcy4uLiI7IHNsZWVwIDMKZG9uZQoKY2QgIiRBUFAiCmlmIFsgISAtZiAiJENPTkZJR19ESVIvLnJhaWx3YXktc2V0dXAtZG9uZSIgXTsgdGhlbgogIDogIiR7Tk9ERUJCX0FETUlOX0VNQUlMOj9OT0RFQkJfQURNSU5fRU1BSUwgbXVzdCBiZSBzZXQgZm9yIHRoZSBmaXJzdCBzdGFydH0iCiAgOiAiJHtOT0RFQkJfQURNSU5fUEFTU1dPUkQ6P05PREVCQl9BRE1JTl9QQVNTV09SRCBtdXN0IGJlIHNldCBmb3IgdGhlIGZpcnN0IHN0YXJ0fSIKICAjIE5ldyBmb3J1bXM6IG5ldyBhY2NvdW50cyB3YWl0IGZvciBhbiBhZG1pbidzIGFwcHJvdmFsIChBQ1AgPiBTZXR0aW5ncyA+IFVzZXIpLgogIG5vZGUgLWUgJ2NvbnN0IGY9Ii91c3Ivc3JjL2FwcC9pbnN0YWxsL2RhdGEvZGVmYXVsdHMuanNvbiIsaj1yZXF1aXJlKGYpO2oucmVnaXN0cmF0aW9uQXBwcm92YWxUeXBlPSJhZG1pbi1hcHByb3ZhbCI7cmVxdWlyZSgiZnMiKS53cml0ZUZpbGVTeW5jKGYsSlNPTi5zdHJpbmdpZnkoaixudWxsLDQpKScKICBsb2cgImZpcnN0IHN0YXJ0OiBydW5uaW5nIHVuYXR0ZW5kZWQgTm9kZUJCIHNldHVwIGZvciBhZG1pbiAnJE5PREVCQl9BRE1JTl9VU0VSTkFNRSciCiAgJEFTIC4vbm9kZWJiIHNldHVwICd7InN1Ym1pdFBsdWdpblVzYWdlIjoibm8iLCJ0cnVzdF9wcm94eSI6MX0nIC0tY29uZmlnPSIkQ09ORklHIgogIG1kNXN1bSBpbnN0YWxsL3BhY2thZ2UuanNvbiB8IGhlYWQgLWMgMzIgPiAiJENPTkZJR19ESVIvaW5zdGFsbF9oYXNoLm1kNSIKICB0b3VjaCAiJENPTkZJR19ESVIvLnJhaWx3YXktc2V0dXAtZG9uZSIKICBjaG93biAtUiAxMDAxOjEwMDEgIiRDT05GSUdfRElSIgogIGxvZyAic2V0dXAgZmluaXNoZWQiCmZpCgojIEtlZXAgY29uZmlnLmpzb24gaW4gc3RlcCB3aXRoIHRoZSBSYWlsd2F5IHZhcmlhYmxlcyAoZG9tYWluLCBwb3J0LCBkYXRhYmFzZSkuCm5vZGUgLWUgJwpjb25zdCBmcz1yZXF1aXJlKCJmcyIpLGU9cHJvY2Vzcy5lbnYsZj1lLkNPTkZJRyxjPUpTT04ucGFyc2UoZnMucmVhZEZpbGVTeW5jKGYsInV0ZjgiKSk7CmMudXJsPWUuTk9ERUJCX1VSTC5yZXBsYWNlKC9cLyskLywiIik7Yy5wb3J0PStlLk5PREVCQl9QT1JUO2MuZGF0YWJhc2U9InBvc3RncmVzIjsKaWYoYy50cnVzdF9wcm94eT09PXVuZGVmaW5lZCljLnRydXN0X3Byb3h5PTE7CmMucG9zdGdyZXM9T2JqZWN0LmFzc2lnbihjLnBvc3RncmVzfHx7fSx7aG9zdDplLk5PREVCQl9EQl9IT1NULHBvcnQ6U3RyaW5nKGUuTk9ERUJCX0RCX1BPUlR8fDU0MzIpLHVzZXJuYW1lOmUuTk9ERUJCX0RCX1VTRVIscGFzc3dvcmQ6ZS5OT0RFQkJfREJfUEFTU1dPUkQsZGF0YWJhc2U6ZS5OT0RFQkJfREJfTkFNRX0pOwpmcy53cml0ZUZpbGVTeW5jKGYsSlNPTi5zdHJpbmdpZnkoYyxudWxsLDQpKTsnCmV4ZWMgJEFTIHRpbmkgLXMgLS0gZW50cnlwb2ludC5zaAo= | base64 -d > /tmp/start.sh && exec bash /tmp/start.sh"`
- **Health check:** /sping
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18.6@sha256:4fc833b43d2aaf6ecc9b18615f5533602b723a32d0e2efe2dae8ca0f7217c863

## Documentation

# 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

* [NodeBB v4.16.7 release](https://github.com/NodeBB/NodeBB/releases/tag/v4.16.7)
* [NodeBB documentation](https://docs.nodebb.org/)
* [NodeBB Docker image and compose files](https://github.com/NodeBB/NodeBB/pkgs/container/nodebb)
* [Railway Postgres image](https://github.com/railwayapp-templates/postgres-ssl)

### 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.



## 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) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/nodebb-1