Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

4.7k Topics 26.3k 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.

  • Memory usage / leak

    8
    0 Votes
    8 Posts
    1k Views
    julianJ

    Honestly I can't imagine why this would be the case. In our experience NodeBB has been fairly stable in terms of memory usage (it will creep up over time, although this is mainly due to post cache and such)...

    What does your ACP dashboard show, are you seeing many visits from spiders? Do you have lots of topics but low user counts?

  • Example Docker Compose Setup?

    2
    1 Votes
    2 Posts
    1k Views
    PitaJP

    Here's one example: https://github.com/boomzillawtf/tdwtf/blob/master/Dockerfile I know they use it in production

  • ACP Loading Extremely slow - 1.8.1

    7
    0 Votes
    7 Posts
    1k Views
    Y

    @pitaj did this make it to 1.8.2? Thanks

  • Unread topics for guests - visibility customizable?

    6
    0 Votes
    6 Posts
    1k Views
    TLINDENT

    Great, I created a widget with the text which is only visible to anonymous users.

    Thanks a lot! 🙂

  • This topic is deleted!

    0
    0 Votes
    0 Posts
    48 Views
    No one has replied
  • Automatic script for installation

    2
    0 Votes
    2 Posts
    726 Views
    PitaJP

    There is none. I suggest donating the Ubuntu installation docs at docs.nodebb.org

  • Random crash after upgraded from 1.5.x to 1.8.2

    5
    0 Votes
    5 Posts
    2k Views
    M

    After last restart forum has been up almost 2 days without crash, no plugin has been disabled. Actually I didn't do anything else, just started NodeBB again.

  • Many NodeBB forums have a message... connection... lost...

    3
    0 Votes
    3 Posts
    1k Views
    J

    @pitaj said in Many NodeBB forums have a message... connection... lost...:

    The "connection lost" message is usually caused because the URL at which you are visiting a NodeBB forum is not the "url" value set in config.json

    I can be on mangolassi.it for hours. Then I leave that tab and work in another tab for a while, and then when I click back on the tab for mangolassi.it I will be spammed with connection lost.

    @scottalanmiller

  • Ubuntu instruction on readthedocs needs to be be fixed

    6
    0 Votes
    6 Posts
    1k Views
    T

    @teh_g There it is, thanks.

  • Moving NodeBB to a different server

    2
    0 Votes
    2 Posts
    817 Views
    barisB

    You need the uploaded files as well which are at public/uploads in the nodebb folder.

  • Users data

    3
    0 Votes
    3 Posts
    788 Views
    Evgeniy OneginE

    @baris thx

  • This topic is deleted!

    1
    0 Votes
    1 Posts
    2 Views
  • How can I get more specific build error message

    7
    1 Votes
    7 Posts
    2k Views
    Gus SurarezG

    It was rather trivial to add the error message, here is how:

    in uglify-js module, added a error reporting log to the file lib\parse.js in following method:

    function js_error(message, filename, line, col, pos) { console.log(message, filename, line, col, pos); throw new JS_Parse_Error(message, filename, line, col, pos); };

    Looks like the error handling of fault barrier doesn't do what it supposed to.

    @PitaJ Thank again for your help.

  • How to "emit" an event from the plugin with callback

    Solved
    4
    0 Votes
    4 Posts
    2k Views
    J

    Indeed its broadcast, thank you. Solved the problem from the client side and moved on. Thank you very very much!!!

  • Problem

    10
    0 Votes
    10 Posts
    2k Views
    Evgeniy OneginE

    Probably i'm really solved ;d
    Just replace url in package.json

    "nodebb-theme-quickstart": "url",

    to

    "nodebb-theme-quickstart": "1.0.0", // your version

    and add --save
    to npm install https://github.com/nodebb/nodebb-theme-quickstart --save

  • E-mail from name not showing

    1
    0 Votes
    1 Posts
    459 Views
    T

    Hi,

    How do I make the e-mails display the name I set under e-mail settings, it shows the e-mail address instead of the name right now.

    I am using the Sparkhost plugin.

  • Maintenance mode - behaviour and controll

    1
    0 Votes
    1 Posts
    462 Views
    N

    Hello,

    I have two questions regarding the maintenance mode.

    When maintenance mode is enabled. How are currently active users affected? Especially what happens if a user is typing/submitting a post while maintenance mode gets activated. Is there a way to controll maintenance mode besides the admin panel? CLI or RestAPI maybe?

    Thanks for your insights.
    Nils

  • Randomly my CSS just broke

    7
    0 Votes
    7 Posts
    936 Views
    PitaJP

    What commands did you use to upgrade?

  • Upgrade fail

    2
    0 Votes
    2 Posts
    705 Views
    PitaJP

    https://community.nodebb.org/post/65860

    Use whichever 1.x version of NodeBB you're currently on.

  • Installing on Heroku

    4
    0 Votes
    4 Posts
    1k Views
    RogerLevyR

    @pitaj Followup to last message ... turns out Heroku does not allow access through any other port than the one it gives you. Is this an insurmountable obstacle and I should look into other hosting, or is there a workaround?