Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

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

  • Themes not showing, admin side

    10
    0 Votes
    10 Posts
    679 Views
    PitaJP

    @qwerty yes, after running ./nodebb stop, NodeBB should not be running.

    What did you try? Does it work when running with ./nodebb dev?

  • Changing the order of multiple badges

    3
    0 Votes
    3 Posts
    404 Views
    barisB

    Probably on nodebb tracker.

  • Nodebb only starts in dev mode on live forum

    1
    0 Votes
    1 Posts
    509 Views
    William RobinW

    Hey there!

    I have a nodebb instance i've been customizing through theming and plugins.

    I recently came across an issue that has prevented me from running ./nodebb start

    Clustering enabled: Spinning up 4 process(es).

    2019-07-22T06:23:35.139Z [4567/15633] - info: Initializing NodeBB v1.12.2 https://kratomwatchdog.com 2019-07-22T06:23:35.431Z [4567/15633] - error: NodeBB could not connect to your Mongo database. Mongo returned the following errorconnect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"],"stack":"MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017\n at Socket.err (/home/ubuntu/nodebb/node_modules/mongodb/node_modules/mongodb-core/lib/connection/connect.js:287:16)\n at Object.onceWrapper (events.js:315:30)\n at emitOne (events.js:116:13)\n at Socket.emit (events.js:211:7)\n at emitErrorNT (internal/streams/destroy.js:66:8)\n at _combinedTickCallback (internal/process/next_tick.js:139:11)\n at process._tickCallback (internal/process/next_tick.js:181:9)"} 2019-07-22T06:23:35.443Z [4567/15633] - error: connect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"]} 2019-07-22T06:23:35.446Z [4568/15638] - error: NodeBB could not connect to your Mongo database. Mongo returned the following errorconnect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"],"stack":"MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017\n at Socket.err (/home/ubuntu/nodebb/node_modules/mongodb/node_modules/mongodb-core/lib/connection/connect.js:287:16)\n at Object.onceWrapper (events.js:315:30)\n at emitOne (events.js:116:13)\n at Socket.emit (events.js:211:7)\n at emitErrorNT (internal/streams/destroy.js:66:8)\n at _combinedTickCallback (internal/process/next_tick.js:139:11)\n at process._tickCallback (internal/process/next_tick.js:181:9)"} 2019-07-22T06:23:35.448Z [4568/15638] - error: connect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"]} 2019-07-22T06:23:35.449Z [4569/15640] - error: NodeBB could not connect to your Mongo database. Mongo returned the following errorconnect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"],"stack":"MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017\n at Socket.err (/home/ubuntu/nodebb/node_modules/mongodb/node_modules/mongodb-core/lib/connection/connect.js:287:16)\n at Object.onceWrapper (events.js:315:30)\n at emitOne (events.js:116:13)\n at Socket.emit (events.js:211:7)\n at emitErrorNT (internal/streams/destroy.js:66:8)\n at _combinedTickCallback (internal/process/next_tick.js:139:11)\n at process._tickCallback (internal/process/next_tick.js:181:9)"} [cluster] Child Process (15633) has exited (code: 0, signal: null) 2019-07-22T06:23:35.454Z [4569/15640] - error: connect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"]} [cluster] Child Process (15638) has exited (code: 0, signal: null) [cluster] Child Process (15640) has exited (code: 0, signal: null) 2019-07-22T06:23:35.462Z [4570/15645] - error: NodeBB could not connect to your Mongo database. Mongo returned the following errorconnect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"],"stack":"MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017\n at Socket.err (/home/ubuntu/nodebb/node_modules/mongodb/node_modules/mongodb-core/lib/connection/connect.js:287:16)\n at Object.onceWrapper (events.js:315:30)\n at emitOne (events.js:116:13)\n at Socket.emit (events.js:211:7)\n at emitErrorNT (internal/streams/destroy.js:66:8)\n at _combinedTickCallback (internal/process/next_tick.js:139:11)\n at process._tickCallback (internal/process/next_tick.js:181:9)"} 2019-07-22T06:23:35.464Z [4570/15645] - error: connect ECONNREFUSED 127.0.0.1:27017 {"name":"MongoNetworkError","errorLabels":["TransientTransactionError"]} [cluster] Child Process (15645) has exited (code: 0, signal: null)

    I am able to run nodebb in dev mode, and have had to run it in a screens session to keep the forum online until i'm able to resolve the issue.

  • This topic is deleted!

    2
    0 Votes
    2 Posts
    8 Views
  • How do I change the colour of the site title?

    9
    0 Votes
    9 Posts
    812 Views
    D

    @PitaJ Actually never mind, I just changed the color of the entire bar instead of trying to figure what the text color was!
    You can delete this thread.

    Although I still think you should add in the next version to ability to change all colors using color selectors in the control panel, as it does not make sense to have some but not others.

  • Creating the nginx file

    6
    0 Votes
    6 Posts
    525 Views
    gotwfG

    @qwerty Are you freakin' serious or punking us? If basics such as this are beyond you then you have absolutely no business deploying server based anything on the Internet. Much less a juicy target for crackers like a forum. Seriously irresponsible. Your name/reputation will be crap once your site is cracked and your users forever hate you. If this sounds harsh, it is because it is meant to. Moderator was being polite.

    That said:

    ESC : wq! Return/Enter

    Good luck!

  • Move MongoDB to clean NodeBB

    Solved
    1
    0 Votes
    1 Posts
    384 Views
    M

    Hello, I'm hosting my NodeBB on Digital Ocean and I want to move everything to an other database. We use MongoDB and we have a few problems. We don't know the MongoDB admin password/username.

    Do you know a way to do this or is there a plugin that makes this easier to do?
    Any help/advice is welcome and are there things we should do and don't do?

  • Removing All categories

    1
    0 Votes
    1 Posts
    282 Views
    emresE

    Hello folks,
    I want to have hackernews-like interface for topic screen. Is there a way to disable all the categories system completely?
    When I disable all categories users can t open new topic anymore.
    When I left only one topic and put everything in users still have to select category while open new topics.
    Any idea?

  • Image upload crash the site

    3
    0 Votes
    3 Posts
    465 Views
    MinettyxM

    Solved, thank you

  • [SOLVED] cookie store

    3
    0 Votes
    3 Posts
    308 Views
    svntyS

    Thanks for the reply

    I added it the config, I had over 300 objects in the session database

  • 0 Votes
    4 Posts
    538 Views
    barisB

    It's already fixed on latest master.

  • Help install nodeBB

    2
    0 Votes
    2 Posts
    515 Views
    PitaJP

    Can you connect to the database from the mongo cli client? If not, them you're using the wrong credentials.

    Additionally, I recommend following the official NodeBB docs: https://docs.nodebb.org/installing/os/ubuntu/

    Third party tutorials can be outdated or incorrect.

  • Upgrade question..

    2
    0 Votes
    2 Posts
    360 Views
    PitaJP

    Yes it should be no problem. It used to be that this wasn't possible but now it should just work.

  • 0 Votes
    2 Posts
    339 Views
    PitaJP

    You can set up a 404 response from the x url inside your reverse proxy. Pretty sure there's a way to report this kind of abuse to Google.

  • Nginx Configuration

    5
    0 Votes
    5 Posts
    508 Views
    J

    @PitaJ
    Ahh I see, thank you

  • DataTables on custom plugin page

    Solved
    13
    0 Votes
    13 Posts
    2k Views
    A

    @JJSagan Thanks for your answer. I tried it but it was making things bad on reloading the page or loading other pages. I will not use datatables (and it will be easier for me on future updates).

  • 0 Votes
    3 Posts
    440 Views
    T

    @julian Yes absolutely. I'd be very happy to have a script that searched for imgur profile pictures and removes them as I'm not experienced with NodeJS at all.

  • HUh.. where is delete category/sub-category?

    5
    0 Votes
    5 Posts
    509 Views
    omegaO

    @julian said in HUh.. where is delete category/sub-category?:

    The way we use "purge" is for clearing out an item from the db, so in our eyes, the nomenclature is correct.

    The function is specific to removing the category from the database. We are careful to not call it deleting because deleting implies that it can be "undeleted", whereas you cannot unpurge something.

    You say potatoes I say tomatoes! 😉

  • 1 Votes
    11 Posts
    793 Views
    julianJ

    Is that change made to my plugin? If so, can you open a pull request to get it in? 😄

  • welcome page error

    3
    0 Votes
    3 Posts
    770 Views
    crazycellsC

    @PitaJ said in welcome page error:

    Please ensure the URL value in config.json matches exactly the URL at which you access your site.

    thanks, that solved the issue.