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
    196 Posts
    phenomlabP

    @baris updated to 3.7.2 and now just waiting for the plugin to be updated.

  • How to fix emojis not served over HTTPS

    7
    0 Votes
    7 Posts
    2k Views
    Gianluca Fiore 0G

    I'm having exactly the same problem.
    The solution of @yariplus does not help me, since then it generates an error when I login to the forum with Google, it tells me ops! an error has happened, our umpa loompas are working to fix it, and it won't let me login, the problem is that the forum is already in production

  • nginx reverse proxy SSL

    4
    0 Votes
    4 Posts
    615 Views
    D

    @oplik0 yeah we are having a loadbalancer before nginx!

    using nodebb without SSL works perfectly using load balancer -> nginx -> nodebb

    I would need to do some more testing but I saw that when using SSL , it redirect to www.domain.tld instead of domain.tld!

    I just modify the nginx config for this vhost to send www. to non-www. and I will re-active the SSL!

    The other thing is, I tried to add

    "socket.io": { "origins": "https://community.nodebb.org:* https://nodebb.org:*" }

    to the config.json and I got an error when starting nodebb

  • 0 Votes
    10 Posts
    753 Views
    T

    That solved my problem. Thank you so much!!!!

  • NodeBB Email doesn't show From Name

    7
    0 Votes
    7 Posts
    493 Views
    barisB

    @Mickola Feel free to send a pull request to https://github.com/julianlam/nodebb-plugin-emailer-sendgrid, if fromname isn't supported in the sengrid nodejs api that should be removed as well.

  • plugin page loading non-stop

    4
    0 Votes
    4 Posts
    503 Views
    D

    @PitaJ shame on me. I missed somewhere that we need to rebuild/restart when we add plugin!

  • 1 Votes
    1 Posts
    231 Views
    D

    Hi,

    Is there a way that our moderator/super moderator can create category and sub-category ?

  • Can moderator add members?

    3
    0 Votes
    3 Posts
    353 Views
    oplik0O

    Are they the owners of their groups (identified by star next to their name in group members list in Persona)? Because even if they're not moderators I believe group owners are able to add people to their group.

  • Lock subject automatically

    4
    0 Votes
    4 Posts
    347 Views
    y hY

    @jac see https://github.com/julianlam/nodebb-plugin-archiver

  • After update Error ENONET

    4
    0 Votes
    4 Posts
    401 Views
    PaladinP

    sudo apt-get install build-essential will fix it.

    Thanks you so much!

    I still don't know what caused everything to turn bad.

  • 0 Votes
    4 Posts
    397 Views
    oplik0O

    The funny thing here is that I just noticed that I broke my page rule for bypassing cache on accident some time ago (made a typo) and it wasn't working, and here I am helping someone deal with a problem I didn't actually solve until now XD

  • Modify skin css

    1
    0 Votes
    1 Posts
    194 Views
    Damien JayD

    Hey there,

    Recently I've been working on my forum and I have been adding a lot of things to the overall look / feel of the forum and my overrides in the admin section are just becoming a bit too much. I've been looking to start moving these into the theme itself when possible, but it appears as though a lot of the overrides are controlled by the skin rather than the theme itself, and while I can put things into .less files and override with !important, I'd rather modify slate to have the correct values and not have to override them -- this ensures that things are rendered properly.

    Is there a way that I can access these skin files somewhere and build them properly?

    Thanks,

  • NodeBB not sorting by date

    1
    0 Votes
    1 Posts
    198 Views
    K

    I'm using NodeBB 1.13.2 and used the write API to upload a bunch of messages from another software into NodeBB. I needed to update the date so I modified the date of each post (using mongodb). The dates for each post are showing the correct date but when I try to sort via newest or oldest it doesn't sort by date order?
    Is there something else I can do to get it to sort the posts in a topic by order? I've already deleted the indexes in mongodb and restarted nodebb to rebuild them but that didn't fix the problem.

    Any ideas?

    Thanks,
    Kyle

  • show new post after submit no longer works

    5
    0 Votes
    5 Posts
    478 Views
    S

    thanks all.. admin disabled a plugin which was trying to send a notification to another system (discord) as part of posting message to bb topic

  • NodeBB Bootstrap error

    2
    0 Votes
    2 Posts
    369 Views
    barisB

    Link Preview Image Fresh installation seems broken

    Use npm i [email protected] until the issue is fixed in jquery. Issue for tracking https://github.com/jquery/jquery/issues/4665

    favicon

    NodeBB Community (community.nodebb.org)

  • Conditional elements in theme based on tags

    Moved
    5
    0 Votes
    5 Posts
    413 Views
    barisB

    You can find some info about the topic/post structures here https://github.com/NodeBB/NodeBB/wiki/Database-Structure.

    For plugin development info you can take a look at https://docs.nodebb.org/development/plugins/

    You can look into the hook filter:topic.build which already has the tags of the topic in the tags field. Then you can add the additional data in that hook for the template to use. Sample hook:

    myPlugin.filterTopicBuild = async function (hookData) { if (hookData.templateData.tags.includes('marvel') { hookData.templateData.posts[0].content += '<br/>this user likes marvel'; } }

    This is just a simple example feel free to modiyy & improve.

  • 0 Votes
    2 Posts
    126 Views
    Patrick MP

    Forgive me if this is a very obvious question. I just can't find the solution for the life of me.

    I've installed and activated the following plugin: nodebb-plugin-category-notifications (https://github.com/NodeBB/nodebb-plugin-category-notifications#readme)
    I then rebuilt & restarted the forum. I was able to get into the admin screen.

    According to the description, my users should now have the ability to subscribe to categories. How do they do so? I don't see a button or option anywhere in proximity to the categories.

    Thanks
    Patrick

  • 0 Votes
    1 Posts
    252 Views
    Tj GiengerT

    The entire error below. I've been searching for some clues, but coming up empty handed and hoping someone can help. This is a fresh install on a debian 10 server.

    2020-04-17T16:33:02.636Z [26376] - error: [build] admin control panel styles build failed 2020-04-17T16:33:02.639Z [26376] - error: resource 'https://fonts.googleapis.com/css?family=Roboto:300,400,500,700' gave this Error: Error: socket hang up {"type":"File","filename":"/var/www/nodebb/nodebb/public/less/admin/paper/bootswatch.less","index":87,"line":5,"column":0,"callLine":null,"extract":["","@import url(\"https://fonts.googleapis.com/css?family=Roboto:300,400,500,700\");",""]} ==================================================================================================================================== 2020-04-17T16:33:02.647Z [26376] - error: resource 'https://fonts.googleapis.com/css?family=Roboto:300,400,500,700' gave this Error: Error: socket hang up {"type":"File","filename":"/var/www/nodebb/nodebb/public/less/admin/paper/bootswatch.less","index":87,"line":5,"column":0,"callLine":null,"extract":["","@import url(\"https://fonts.googleapis.com/css?family=Roboto:300,400,500,700\");",""]} (node:26376) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). To terminate the node process on unhandled promise rejection, use the CLI flag `--unhandled-rejections=strict` (see https://nodejs.org/api/cli.html#cli_unhandled_rejections_mode). (rejection id: 1) (node:26376) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.
  • 0 Votes
    22 Posts
    2k Views
    F

    @gotwf I truly miss zfs

  • SMTP parameters reset

    3
    0 Votes
    3 Posts
    586 Views
    gotwfG

    @qxpd Possible and maybe even likely if your uninstall was incomplete. What platform are you on? How are you sending mail? Are you running your own smtp relay? If so, what are you using? Exim? Postfix? Or using third party SMTP relay service? Cuz those types of small details really do make a big difference.

    As to the error message above, port 587 is the "well known" Submission port for SMTP. 127.0.0.1 is the local host's "loop back" interface which your machine favors for moving bits about whilst talking to itself. In this case: NodeBB is trying, unsuccessfully, to relay mail to the world via an SMTP server running on your local host. Is there one? If you do not know, you should not be running your own mail server as there be lots of security related dragons lurking thereabouts for even seasoned sysadmins.

    Hence, unless you want to shoulder the responsibility of running your own SMTP server I'd suggest using a third party relay. Now, one thing that IS relatively simple to set up is a Null Client Relay, that ONLY accepts mail from the trusted local host and then relays that mail via SMTP protocol to your upstream internet facing smtp relay. Faster than the nodejs built in. And it is nice to have a "mail spool" in event outbound mail gets backed up for some reason. But that built-in works too. And a non issue with smaller sites. At least last time I looked at it.

    Hope this helps some.

  • Consider add to documentation: Node version

    7
    0 Votes
    7 Posts
    750 Views
    gotwfG

    Sharp seems to have a bit of history for being somewhat of a thorn in the side....

    Link Preview Image 1.10.1 → 1.10.2 libvips + whole X server dependency?

    @rfc2822 Yes, sharp replaced jimp in 1.10.2 to fix some bugs. See: https://github.com/NodeBB/NodeBB/pull/6774 As far as I can tell libvips only need those X1...

    favicon

    NodeBB Community (community.nodebb.org)

    It was confusing to me as well when I first tried taking NodeBB for a test drive. Great support here though for getting such glitches sorted. 👍