# NodeBB — Modern Self-Hosted Community Forum on Node.js

> A fast, extensible forum platform built on Node.js with real-time interactions, plugin support, and mobile-friendly design for building engaged communities.

## Install

Save as a script file and run:

# NodeBB — Modern Self-Hosted Community Forum on Node.js

## Quick Use
```bash
git clone https://github.com/NodeBB/NodeBB.git
cd NodeBB
./nodebb setup
./nodebb start
```

## Introduction
NodeBB is a next-generation forum platform powered by Node.js. It uses WebSockets for real-time notifications, live topic updates, and instant messaging. Its plugin and theme system allows deep customization, and it supports Redis, MongoDB, or PostgreSQL as its data store.

## What NodeBB Does
- Provides a threaded discussion forum with categories, topics, and replies
- Delivers real-time notifications and live-updating content via WebSockets
- Supports social login, two-factor authentication, and granular permissions
- Includes built-in chat, user reputation, and badge systems
- Offers a plugin architecture with hundreds of community extensions

## Architecture Overview
NodeBB is a Node.js application that uses Socket.IO for bidirectional real-time communication. Content and user data are stored in a pluggable database layer supporting Redis, MongoDB, or PostgreSQL. Templates are rendered server-side with Benchpress.js and enhanced client-side. The plugin system hooks into core events, enabling extensions to modify behavior without forking the core.

## Self-Hosting & Configuration
- Install Node.js 18+ and one of Redis, MongoDB, or PostgreSQL
- Run `./nodebb setup` to configure database, admin account, and site URL
- Use `./nodebb start` for production or `./nodebb dev` during development
- Deploy with Docker using the official `nodebb/docker` image
- Configure Nginx or Caddy as a reverse proxy with WebSocket support

## Key Features
- Real-time interactions make discussions feel responsive and alive
- Social integrations support login via Google, GitHub, Twitter, and more
- Internationalization covers 50+ languages out of the box
- Widget system lets admins add custom content blocks to any page
- SEO-friendly with server-side rendering and structured data markup

## Comparison with Similar Tools
- **Discourse** — Ruby-based forum with a large community; NodeBB is lighter and uses Node.js with real-time WebSockets
- **Flarum** — PHP forum with a modern UI; NodeBB offers deeper real-time features and a larger plugin ecosystem
- **phpBB** — classic PHP forum; NodeBB provides a more modern stack and UX
- **Vanilla Forums** — commercial with an open-source edition; NodeBB is fully open source
- **Forem** — community platform behind DEV.to; NodeBB is more focused on traditional forum features

## FAQ
**Q: Which database should I choose?**
A: Redis offers the best performance for small to medium forums. PostgreSQL is recommended for larger deployments that need robust SQL querying. MongoDB is also supported.

**Q: Can NodeBB handle large communities?**
A: Yes. NodeBB can scale horizontally with multiple Node.js processes behind a load balancer and a shared database.

**Q: Does NodeBB support SSO?**
A: Yes, via plugins for SAML, OAuth2, LDAP, and OpenID Connect. Social login providers are supported natively.

**Q: Is there a migration path from other forum software?**
A: NodeBB includes importers for phpBB, Discourse, MyBB, vBulletin, and other platforms.

## Sources
- https://github.com/NodeBB/NodeBB
- https://docs.nodebb.org

---
Source: https://tokrepo.com/en/workflows/bacd74b6-3e67-11f1-9bc6-00163e2b0d79
Author: Script Depot