Skip to content

mrahmed2026/NodeBB

This branch is up to date with CMU-17313Q/NodeBB:f24.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

09ad0fe · Aug 25, 2024
May 10, 2024
Aug 25, 2024
Feb 28, 2021
Feb 12, 2024
Apr 13, 2018
Aug 1, 2024
Feb 27, 2014
Jul 31, 2024
Jul 31, 2024
Aug 18, 2024
Nov 30, 2023
Sep 8, 2021
Nov 12, 2023
Jan 20, 2015
Nov 12, 2023
Aug 8, 2021
Jul 21, 2015
May 10, 2024
May 4, 2020
Jun 27, 2024
May 23, 2024
Jul 12, 2023
Jun 17, 2013
Aug 18, 2024
Jul 26, 2022
Oct 30, 2020
May 23, 2024
May 15, 2024
May 14, 2024
May 15, 2024
Mar 13, 2024
Nov 23, 2017
Jan 18, 2019
Jul 25, 2022
Oct 31, 2018
Sep 30, 2023
Mar 17, 2023
Apr 30, 2022
Oct 14, 2022

Repository files navigation

NodeBB

Workflow Coverage Status Quality Gate Status

NodeBB Forum Software is powered by Node.js and supports either Redis, MongoDB, or a PostgreSQL database. It utilizes web sockets for instant interactions and real-time notifications. NodeBB takes the best of the modern web: real-time streaming discussions, mobile responsiveness, and rich RESTful read/write APIs, while staying true to the original bulletin board/forum format → categorical hierarchies, local user accounts, and asynchronous messaging.

NodeBB by itself contains a "common core" of basic functionality, while additional functionality and integrations are enabled through the use of third-party plugins.

Screenshots

NodeBB's theming engine is highly flexible and does not restrict your design choices. Check out some themed installs in these screenshots below:

Our minimalist "Harmony" theme gets you going right away, no coding experience required.

Rendering of a NodeBB install on desktop and mobile devices

How can I follow along/contribute?

  • If you are a developer, feel free to check out the source and submit pull requests. We also have a wide array of plugins which would be a great starting point for learning the codebase.
  • If you are a designer, NodeBB needs themes! NodeBB's theming system allows extension of the base templates as well as styling via SCSS or CSS. NodeBB's base theme utilizes Bootstrap 5 as a frontend toolkit.
  • If you know languages other than English you can help us translate NodeBB. We use Transifex for internationalization.
  • Please don't forget to like, follow, and star our repo! Join our growing community to keep up to date with the latest NodeBB development.

Requirements

NodeBB requires the following software to be installed:

  • A version of Node.js at least 16 or greater (installation/upgrade instructions)
  • MongoDB, version 3.6 or greater or Redis, version 2.8.9 or greater
  • If you are using clustering you need Redis installed and configured.
  • nginx, version 1.3.13 or greater (only if intending to use nginx to proxy requests to a NodeBB)

Installation

Please refer to platform-specific installation documentation. If installing via the cloud (or using Docker), please see cloud-based installation documentation.

Securing NodeBB

It is important to ensure that your NodeBB and database servers are secured. Bear these points in mind:

  1. While some distributions set up Redis with a more restrictive configuration, Redis by default listens to all interfaces, which is especially dangerous when a server is open to the public. Some suggestions:
    • Set bind_address to 127.0.0.1 so as to restrict access to the local machine only
    • Use requirepass to secure Redis behind a password (preferably a long one)
    • Familiarise yourself with Redis Security
  2. Use iptables to secure your server from unintended open ports. In Ubuntu, ufw provides a friendlier interface to working with iptables.
    • e.g. If your NodeBB is proxied, no ports should be open except 80 (and possibly 22, for SSH access)

Upgrading NodeBB

Detailed upgrade instructions are listed in Upgrading NodeBB

License

NodeBB is licensed under the GNU General Public License v3 (GPL-3) (http://www.gnu.org/copyleft/gpl.html).

Interested in a sublicense agreement for use of NodeBB in a non-free/restrictive environment? Contact us at [email protected].

More Information/Links

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 88.0%
  • Smarty 10.6%
  • SCSS 0.9%
  • HTML 0.2%
  • Shell 0.1%
  • Dockerfile 0.1%
  • Other 0.1%