TiloBox
Back to directory
NodeBB project preview
Community ForumAlternative to phpBBAlternative to DiscourseAlternative to Vanilla Forums

NodeBB

Modern open-source forum software built for the social web and alternative to Discourse.

View on GitHub Visit website
LicenseGPL-3.0
GitHub stars15.2k
Last commit1 weeks ago
Tags6 topics
CommunityNodejsRedisForumSelf HostedReal Time
Overview

Why consider NodeBB?

NodeBB is a high-performance forum platform built with Node.js and Redis. It features real-time notifications, native mobile apps, rich plugin ecosystem, and analytics.

Guided learning

Learn NodeBB by building

Practical setup notes, real use cases, and copy-ready examples in one focused guide.

3 min read 10 sections
In this guide10 sections

What is NodeBB?

NodeBB is a modern, high-performance open-source forum platform built with Node.js, Socket.io, and Redis. It operates as a fast, feature-rich alternative to community forum software like Discourse, phpBB, and Vanilla Forums.

NodeBB delivers real-time forum interactions powered by WebSockets: users receive instant notifications, see live typing indicators, and watch new posts appear without manual page refreshes. Its responsive design provides a native-feeling experience across desktop and mobile browsers, supplemented by official Android and iOS mobile apps.

Who Is It For?

  • SaaS Companies: Hosting community support forums and knowledge-sharing spaces for customers and partners.
  • Online Communities: Running niche hobby, gaming, or professional communities with a polished, modern forum UX.
  • Educational Institutions: Building student and faculty discussion forums with private category access control.

Key Features

  • Real-time interactions: WebSocket-powered instant post delivery, notification toasts, and live user presence.
  • Rich plugin and theme marketplace: 500+ community plugins (SSO, analytics, gamification, Markdown).
  • Granular privilege control: Per-category, per-group, and per-user read/write/admin permissions.
  • REST API: Programmatically create posts, manage users, and query forum data for integration.
  • Full-text search with built-in or Elasticsearch backends.

Deploying NodeBB with Docker Compose

yaml
1version: '3.7'
2
3services:
4 mongo:
5 image: mongo:6-jammy
6 container_name: nodebb_mongo
7 restart: unless-stopped
8 volumes:
9 - ./mongo_data:/data/db
10
11 nodebb:
12 image: nodebb/docker:latest
13 container_name: nodebb_app
14 restart: unless-stopped
15 ports:
16 - "4567:4567"
17 environment:
18 - url=http://localhost:4567
19 - secret=generate_a_secure_random_nodebb_secret
20 - database=mongodb
21 - mongo__host=mongo
22 - mongo__port=27017
23 - mongo__database=nodebb
24 volumes:
25 - ./nodebb_build:/usr/src/app/build
26 - ./nodebb_uploads:/usr/src/app/public/uploads
27 depends_on:
28 - mongo

Start the instance:

bash
1docker compose up -d

Open http://localhost:4567 in your browser to complete the NodeBB setup wizard.

Practical Use Cases

1. SaaS Customer Community Forum

A software company launches community.theirproduct.com on NodeBB, integrating SSO so existing customers log in with their product accounts seamlessly.

2. Gaming Community with Gamification

A gaming forum enables NodeBB's reputation system and badge plugins; active posters earn leveling badges that appear on their forum profiles.

3. Private Employee Intranet Forum

An HR department creates password-protected categories visible only to department employees, hosting internal policy discussions and team announcements.

Troubleshooting and Limitations

  • Database Choice: NodeBB supports MongoDB and Redis as primary datastores; PostgreSQL support is experimental. Choose MongoDB for feature completeness.
  • Plugin Compatibility: After NodeBB version upgrades, verify plugin compatibility in the Admin Panel before running ./nodebb upgrade on production.

Official Resources

Related tools

More options with a similar category or technology profile.

Lemmy logo

Lemmy

Federated, open-source link aggregator and Reddit alternative built on the ActivityPub protocol.

NodeBB FAQs

NodeBB is listed as a Community Forum tool on TiloBox. Review the overview, features, and official documentation on this page to decide whether it solves your specific workflow.

Start with the project's GitHub repository and official website for supported installation and deployment instructions. Test the setup with representative data or a small project before rolling it out more widely.

NodeBB is listed under the GPL-3.0 license. Read the complete license text and the project's notices before using, modifying, or distributing the software.

Production readiness depends on your requirements. Review maintenance activity, security practices, documentation, backup and upgrade procedures, and compatibility with your stack; then validate it in a non-production environment.

NodeBB is listed as an alternative to phpBB. Compare the core workflow, deployment model, integrations, and licensing against your must-have requirements before switching.