Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

4.7k Topics 26.2k Posts

Subcategories


  • User documentation for NodeBB

    44 Topics
    44 Posts
    Jay MoonahJ

    One of the first important things to do after setting up NodeBB is to set up an emailer plugin. While NodeBB does include a local emailer, if your forum is particularly active we recommend using an third-party emailer such as SendGrid which provides better deliverability for sites that send a high volume of email. Setting up SendGrid in NodeBB is very easy.

    Open the administrative dashboard using the 'gear' icon on your forum. Open the Extend > Plugins menu, and select the Find Plugins tab. Use the search on the right. Type 'SendGrid' and the plugin should appear -- select Install when you see it. From Installed tab on the Plugins menu, search again for 'SendGrid' and select Activate. Activating the plugin will require a restart of your forum. To restart, select the Dashboard menu and press the Restart button to the right. After NodeBB restarts, the SendGrid plugin will be active.

    After you restart, there should be a item called Emailer (SendGrid) under the Plugins menu -- if you don't see this right away, try refreshing your browser.

    Sign up to SendGrid

    Go to the SendGrid website, open the pricing page and scroll to the bottom. Click on the link and create your free account. Once you've confirmed your SendGrid account via email, you should be able to login to the SendGrid website. On the left side of your SendGrid dashboard, open Settings and click on API Keys. Click the button in the top right to create a new key. Make sure that the key has Full Access for Send Mail and Alerts.  When you are done, the new key to your clipboard.

    Now, return to the SendGrid menu on your NodeBB admin panel. Paste the API key into the field, and save your changes. Now go back to the Dashboard to restart your forum one more time.

    SendGrid should now be working for your forum.

    YouTube Setting up SendGrid mailer for NodeBB

  • NodeBB guides, how-to's and general tips and tricks

    82 Topics
    599 Posts
    barisB

    Quick start plugin has an example on how to add a new api route https://github.com/NodeBB/nodebb-plugin-quickstart/blob/master/library.js#L40-L76.

    The hooks that are fired client side are for client side code in plugins. If you want to pass data from the client to the server you have two options.

    Create an api route like in quick start plugin Create a new socket event listener on the server side and use socket.emit() client side. Example here
  • 25 Topics
    201 Posts
    eeeeeE

    I think you answered my point, by agreeing there are issues.
    I didn't even attempt to deploy nodebb, I had problems with much smaller projects!
    Nextjs routing was going through a change of design at the time, so perhaps that is less confusing now, but there were multiple other headaches. I would get build errors and issues with package management.

  • Announcements

    3
    0 Votes
    3 Posts
    411 Views
    PitaJP

    It's just a sidebar widget.

  • Editing Persona Theme

    2
    0 Votes
    2 Posts
    485 Views
    TaLocheT

    In the ACP, just put this in the Custom CSS section

    .categories-title { display: none; }
  • Can't upgrade nodebb problem

    4
    0 Votes
    4 Posts
    686 Views
    C

    Problem solved. For this topic to be any usefull at all:

    Run into first problem trying to point and click install 2 nodebb instances( test and the actual) on the same server and obviously, both couldn't listen on the same 4567 port.

    Second, did the second install from the old docs on readthedocs instead of the official ones from nodebb.

    Third, forgot to also add php-fpm directives to my Nginx config. And start Mongodb.

  • Cloudflare, ssl ...

    1
    0 Votes
    1 Posts
    446 Views
    J

    Hello,

    I just try to create a new forum for a gaming community... I love nodebb and it is so fast and easy to configure... sadly I‘ve got problems with cloudflare and ssl... as soon as i activate the cloudflare clouds , my nodebb looses connection... i cant imagine that i need to change something in my conf or Nginx configuration? It‘s the same url, same port.. and also the ssl certificate doesn’t work which is free on cloudflare... do i need to change something in my config files or activate my ssl in the Nginx files? I found a cloudflare tutorial here in the forum but it seems to be outdated, because later in the answers everybody wrote something like cloudflare works now with sockets so there’s nothing to change in the config files ... hope somebody knows what I need to do...

  • 0 Votes
    4 Posts
    975 Views
    Sea AnsleyS

    OK... removing the port, :4567 - helped with the Google SSO to finally work.

    just "https://digital.nomadic.cloud" - and it's working fine.

    I know that during the set up process (tried 5 times previously), ensuring the port here made a difference with making something else work.

    When I see that bug again, I will post that separately.

    and.. thank you 🙂

  • 0 Votes
    3 Posts
    2k Views
    gh0-0stG

    Thank you for your quick answer Julian.

    I hope the update to less v3 can be so fast ☺
    At least thank you for your explanation, I'm on the lookout to be able to use nodebb

  • 0 Votes
    2 Posts
    1k Views
    bonaccorsopB

    Ok, I solved it by binding a different port from 80 in my config.json:

    { "url": "https://dev.myforum.com", "port": 4567, "database": "mongo", ... }

    So finally NodeBB set express.sid cookie 🙂

  • Category Specific Permissions?

    5
    0 Votes
    5 Posts
    758 Views
    L

    Lol thanks, didn't see that!

  • Few questions about NodeBB

    6
    0 Votes
    6 Posts
    859 Views
    D

    @julian Clear enough, thank you so much.

  • 0 Votes
    6 Posts
    999 Views
    PitaJP

    @asamolion Here are the changes:

    Link Preview Image Precompile all templates by pitaj · Pull Request #6649 · NodeBB/NodeBB

    Benchpress compilation is 33x faster now Native module with JS fallback and pre-built binaries Dev template build is <1sec now Minified template build is ~5sec (uglify accounts for almost all)

    favicon

    GitHub (github.com)

    Just use the latest version of benchpressjs (not 1.2.3)

  • 0 Votes
    7 Posts
    904 Views
    julianJ

    Does it work if you don't put it in the error_docs/ subfolder?

  • service-worker request 404 not found

    1
    0 Votes
    1 Posts
    318 Views
    hawmH

    The service worker request not found, the url like
    https://www.example.com/service-worker-b3132ce44c958878a3dc19776072ad3861a661ca983e3c8f0269c27a439d47d2.js

    I tried to rebuild and restart nodebb but not fix. It's that a problem?

  • Problem when installing

    1
    0 Votes
    1 Posts
    373 Views
    SrPeterS

    Linux version: Red Hat 4.8.5-16

    Hello!
    I am actually trying to install NodeBB in a shared hosting, so im using the terminal. I have all the files in the correct folder, but when I try to "./nodebb setup" I get this:
    /usr/bin/env: node: No such file or directory
    I am assuming bevause i have got Node.js installed, but I cant seem to install it with any commands from https://docs.nodebb.org/installing/os/
    😞

  • Excessive Load Warning

    1
    0 Votes
    1 Posts
    328 Views
    C

    This is my first day with NodeBB and I don't know how everything works.

    Since the site is basically new, but testing different bits here and there, I was a little bit worried getting two times an error page with Excessive Load Warning. I have a VPS with one core and 2GB of RAM.

  • 0 Votes
    1 Posts
    351 Views
    Klint Abong EspadonK

    Re: nodebb web setup - Configure your database - Digital Ocean

  • Configuration Error: unknown database

    3
    0 Votes
    3 Posts
    717 Views
    C

    @baris Thank you so much. Caught in the installing process didn't saw that. Now I have a working NodeBB site. For the first test install used everything as is in the tutorial so database is nodebb.

  • nodebb disconnect

    3
    0 Votes
    3 Posts
    529 Views
    radish-angelR

    every other 5 minutes, my browser console many errors, eg:
    GET http://www.seenewyun.com/socket.io/?EIO=3&transport=polling&t=MOJNhdj 502 (Bad Gateway)
    ,but nodebb can auto connect.

  • External Links not redirecting properly

    5
    0 Votes
    5 Posts
    594 Views
    brian4021B

    Alright, thank you for the quick response 🙂

  • 0 Votes
    4 Posts
    806 Views
    PitaJP

    @01 "it won't open" isn't very descriptive. What is it actually doing? Screenshots are very helpful to convey that info.

    What is your nginx config? Where did you get your https certificates? Have you been following a guide, and if so, which one?

  • how to add HTML content in topics

    Solved
    2
    0 Votes
    2 Posts
    2k Views
    julianJ

    Use of the Markdown composer is optional, and you can save HTML directly into the database, and this is what is used for other composers like Redactor. Still other composers (Quill composer) save content into the database in their own special format.

    Markdown is not meant to be activated for either of those.

    Alternatively you could allow HTML in the markdown settings, but I would highly advise you also install sanitizehtml plugin, otherwise anyone can post anything including malicious scripts as a post in your forum!