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.

  • How about update fontawesome?

    2
    4 Votes
    2 Posts
    1k Views
    A

    Agreed. ๐Ÿ‘

  • Required markup

    Moved
    5
    1 Votes
    5 Posts
    2k Views
    H

    @julian how about running one huge find and replace job? Wait... on second thoughts maybe not ha

  • List of templates available

    Moved
    4
    0 Votes
    4 Posts
    3k Views
    julianJ

    Also /src/views/, for ACP templates

  • How to disable the update teaser?

    13
    0 Votes
    13 Posts
    4k Views
    X

    @baris Oh, it really works.
    Thanks a lot for the help!

  • Question about NodeBB Pricing

    14
    0 Votes
    14 Posts
    4k Views
    JenklerJ

    Cool ๐Ÿ˜‰

    I only got one, but that is better than nothing right ๐Ÿ˜›

  • 0 Votes
    5 Posts
    2k Views
    apilorussoA

    Very odd! I accessed the forum from my work computer and I can see it. Although I noticed when I tried on mobile the "Nav Tree" disappears behind the header. Maybe its a browser based issue?

  • sudo nodebb help

    5
    0 Votes
    5 Posts
    3k Views
    C

    ok got it working again i re-took ownership of the entire directory again... maybe a i did a sudo git pull by mistake or something silly

    opps xd

  • Division line at footer

    4
    1 Votes
    4 Posts
    1k Views
    julianJ

    @drew I'd totally be in favour of the footer being outside of the container... ๐Ÿ˜„

  • Settings โ†’ Notifications usage

    3
    0 Votes
    3 Posts
    1k Views
    FastidiousF

    @a_5mith, thank you. Those two sentences (modified to fit the context) should be added to that screen.

  • 0 Votes
    9 Posts
    4k Views
    P

    404 Not Found

    favicon

    (docs.nodebb.org)

    There's an edit button on the top right, and making a new page is as easy as just cloning and copying and pasting another guide and editing it

  • Strange behavior

    4
    1 Votes
    4 Posts
    2k Views
    P

    NodeBB's cache buster is based on its current git hash (so if you've upgraded it will try to send you the new CSS and JS, which works well, but it remains the same if switching themes, which results in your issue)

    I suppose the dev team hasn't run into this because we usually run with cache disabled while testing (and because Persona is so awesome so why switch? Kidding)

    Link Preview Image Update cache buster when switching themes ยท Issue #3573 ยท NodeBB/NodeBB

    Right now cache buster is based on git hash, which works fine when upgrading. Not as good when switching themes or installing plugins. I suggest modifying cache buster algo to just generate a new one every time forum restarts or reloads

    favicon

    GitHub (github.com)

  • How to remove all topics and posts from database?

    Unsolved
    21
    0 Votes
    21 Posts
    8k Views
    H

    @Fastidious hehe I did feel like I was using a sledgehammer to crack a nut at the time.

  • Google SSO error

    5
    1 Votes
    5 Posts
    2k Views
    drewD

    @Fastidious That's because Twitter SSO is the WOOOOORST. It gives no email address. So you can't link it to an existing user. #fail

  • Recently logged in IPs issue

    3
    0 Votes
    3 Posts
    1k Views
    drewD

    @Fastidious Thanks for sharing the fix.

  • Installing on FreeBSD, error

    13
    0 Votes
    13 Posts
    4k Views
    R

    Ok,. I have just thought every gcc48 version would crash for you. โ€“ So everything is OK ๐Ÿ™‚

    Really love NodeBB & FreeBSD ๐Ÿ™‚

  • Github issue importer

    3
    2 Votes
    3 Posts
    1k Views
    R

    No, it's not publically available because it doesn't meet my quality requirements for publication. I can send it to you if you're interested.

  • Where does NodeBB compile templates?

    13
    0 Votes
    13 Posts
    3k Views
    P

    Yeah its on my todo for tjs 1.0 ๐Ÿ™‚

  • 0 Votes
    12 Posts
    6k Views
    Charly86C

    @julian,
    it 's the same thing

    Internal error. Oops! Looks like something went wrong! /auth/github/callback Cannot read property '0' of undefined

    is there a way to clear github related information from a user in the nodebb database ?

  • Help: First Theme (Bringing Back The Blocks)

    Moved
    5
    2 Votes
    5 Posts
    2k Views
    tfraleyT

    Cool @drew look forward to it, let me know if I can be of any help.

  • Put on Google

    4
    0 Votes
    4 Posts
    1k Views
    P

    yourdomain.com/sitemap.xml

    It's active by default on NodeBB ๐Ÿ™‚