# NodeBB

> Forum software for your community, with live chat.

- Page: https://cgt.octabyte.io/templates/nodebb/
- Category: Community forums
- Replaces: Circle
- Ease of use: Some setup. Sign in with the admin username you chose and the password Cloudgate shows, then add your email server so members can confirm their email.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: GPL-3.0-only
- Good for: Companies, projects and clubs that want a modern forum on their own domain, with no fee per member
- Official website: https://nodebb.org
- Documentation: https://docs.nodebb.org
- Source code: https://github.com/NodeBB/NodeBB
- Last updated: 2026-11-20

## What is NodeBB?

NodeBB is self-hosted forum software for your community: categories, live replies, member chat, moderation and fediverse sharing, on your own domain.

NodeBB is free, open-source, self-hosted forum software for running a community or support forum on your own domain, as an alternative to paid community platforms such as Circle or to a Facebook group. Members start topics in categories, reply, vote and chat, and new posts appear live without reloading the page.

A bike co-op, for example, could run a forum where members ask repair questions, plan weekend rides and read workshop announcements, with new members' first posts checked by a volunteer before they appear. Roles and permissions let you keep some categories for staff or members only.

NodeBB also connects to the fediverse, so people on Mastodon can follow and reply to public discussions, and plugins add features such as single sign-on. It works in any phone or computer browser; there is no separate phone app.

Cloudgate installs NodeBB on a server Cloudgate provides or one you connect, together with its database, and gives it a secure web address. It creates the admin account during setup: sign in with the username you chose and the password Cloudgate shows. Anyone can sign up until you change that in the admin settings, and members need email set up to confirm their address.

## What you can do with NodeBB

- **Organise discussions**: Group topics into categories, add tags, and let members vote, bookmark and watch topics.
- **See replies as they happen**: New topics, posts and notifications appear live, without reloading the page.
- **Chat with members**: Members can send each other private messages and chat right inside the forum.
- **Keep it friendly**: New members' posts wait in a review queue, members can flag posts, and moderators can ban spammers.
- **Decide who can do what**: Set roles and permissions for each category and group, such as staff-only or members-only areas.
- **Connect to the fediverse**: People on Mastodon and similar networks can follow and reply to your forum's public discussions.
- **Works on any phone**: The forum is built for small screens first and can send push notifications from the browser.

## Replaces Circle

NodeBB does the same job as Circle. Here is what changes when you switch.

### What you gain

- No monthly fee per plan and no transaction fees; you pay only for your server
- Your members, posts and data stay on your own server and domain
- Live updates, chat and fediverse sharing built in

### What is different

- NodeBB is a discussion forum; there are no built-in courses, events or paid memberships
- No native phone apps; members use the forum in their phone's browser
- Extra features such as single sign-on come from plugins
- There is no built-in tool to import a community from Circle

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=nodebb

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. NodeBB itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up NodeBB.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is NodeBB free?

Yes, NodeBB is free and open source under the GPL-3.0 licence, with no paid edition. You pay only for your server; its makers also sell hosting if you would rather not run it yourself.

### Is NodeBB a good alternative to Circle?

Yes, if what you need is a discussion forum on your own domain with no fee per plan or transaction. NodeBB has categories, live replies, chat and moderation, but unlike Circle it has no built-in courses, events or paid memberships.

### NodeBB vs Discourse, which should I choose?

Both are open-source forum software you can host yourself, and Discourse also sells hosted plans. NodeBB updates conversations live, includes member chat and connects to the fediverse out of the box, so it suits communities that want a real-time forum with chat.

### How do I sign in to NodeBB the first time?

NodeBB sets itself up during installation. Sign in with the admin username you chose, admin unless you changed it, and the password Cloudgate generated, which is shown on the app's page in Cloudgate.

### Can anyone sign up to my NodeBB forum?

Yes. By default anyone can register on a NodeBB forum, and new members' posts wait in a review queue until a moderator approves them. To make the forum invite-only, require admin approval or close sign-ups, change Registration Type under Admin > Settings > User.

### Does NodeBB work with Mastodon and the fediverse?

Yes, NodeBB supports ActivityPub, and federation is on by default, so people on Mastodon and similar networks can follow and reply to public discussions. Review the federation settings in the admin area if you want to keep the forum to itself.

### Do I need to set up email for NodeBB?

Yes, for a good member experience. Until you add your email server in NodeBB under Admin > Settings > Email, members see a notice that their email is unconfirmed, may not be able to post in some categories or chat, and cannot reset their password.

### Do I need technical skills to run NodeBB?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up NodeBB and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for NodeBB?

No. When you deploy NodeBB, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

### Can I move my data from Circle to NodeBB?

Most people export from Circle and import into NodeBB. The official guides at docs.nodebb.org walk through it.
