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.

  • Transfer host to new server

    7
    0 Votes
    7 Posts
    653 Views
    catC

    @julian Yeah I was wondering why my default avatars, default headers, etc were broken. Other than that, zipping the nodebb folder on old server, then deploying on Heroku git should just work ☺

  • Modifying manifest.webmanifest

    Solved
    6
    0 Votes
    6 Posts
    142 Views
    barisB

    Oh if you don't have access then build a plugin that serves the file. You can use any url you want that way.

    app.get('/some/custom/url', function (req, res) { res.sendFile('path/to/hello.txt'); });
  • CSRF Error - NodeBB 3.x

    Solved
    4
    0 Votes
    4 Posts
    147 Views
    yasasY

    @DownPW Haha jinxx

  • Import plugin issues

    Unsolved
    2
    0 Votes
    2 Posts
    67 Views
    PitaJP

    Was this not clear?

    Link Preview Image Plugin Nodebb Plugin-Import: error Loading

    I recommend you read the instructions: https://github.com/akhoury/nodebb-plugin-import THIS PLUGIN ONLY SUPPORTS: NodeBB v1.12.1 but you can upgrade after t...

    favicon

    NodeBB Community (community.nodebb.org)

    The import plugin does not support latest NodeBB

  • Plugin Nodebb Plugin-Import: error Loading

    Unsolved
    4
    0 Votes
    4 Posts
    393 Views
    barisB

    Once you import on nodebb 1.12.1, you can then upgrade all the way to 3.x with ./nodebb upgrade

  • Guest priviledges for Posts

    Unsolved
    2
    0 Votes
    2 Posts
    65 Views
    julianJ

    Can you show us what you mean? The guests row should not be greyed out

  • CORS problems using NodeBB API

    Unsolved
    3
    0 Votes
    3 Posts
    98 Views
    Antonio Peña BatistaA

    @PitaJ said in CORS problems using NodeBB API:

    Certain browsers treat localhost differently with CORS stuff. I recommend you try using 127.0.0.1 or some other IP address instead.

    but for my app or for the forum?

  • Performing bulk actions on "flags" causes nginx 503 error

    Solved
    4
    0 Votes
    4 Posts
    122 Views
    julianJ

    This likely cropped up because flag actions now use the v3 API instead of socket.io, so it could be it overloaded the backend, which started sending 503s.

  • No Admin account after first setup

    Moved
    3
    0 Votes
    3 Posts
    126 Views
    fishcoderF

    yeah, thank you. I've solved it with deleting the database. In the logs I found the error of skipping the creation of the admin user, because it already exists.

  • Can I add nodebb to express based website?

    Unsolved
    2
    1 Votes
    2 Posts
    97 Views
    J

    @marksibly I would recommend doing it through the reverse proxy (nginx caddy or whatever you use), and not to mediate through the node.js
    Caddyfile example (https://caddyserver.com) :

    mywebsite.com { reverse_proxy /forum/* localhost:4567 # nodebb default port reverse_proxy localgost:3000 # your node.js app port }

    Then set the address in the config.json file of the nodebb:

    { "url": "https://mywebsite.com/forum/", ... }

    and then run

    ./nodebb build ./nodebb restart

    And the forum will be available at https://mywebsite.com/forum/ (be sure to keep the / at the end)

  • 0 Votes
    3 Posts
    108 Views
    S

    @baris Thanks a lot for replying, and I apologize for wasting your time 😞
    I somehow got the markdown plugin disabled while upgrading, hence the issue.
    Enabling it back up solved it.

  • Running the forum after restarting the computer

    Unsolved
    17
    0 Votes
    17 Posts
    483 Views
    J

    @Thmhe said in Running the forum after restarting the computer:

    @josef said in Running the forum after restarting the computer:

    nodebb.bat

    ?What I need to write in the program is

    nodebb.bat

    How should I proceed from here?
    b22a02f7-4f82-4f3a-8616-4e66ece020a5-image.png

    @josef said in Running the forum after restarting the computer:

    and add a "start" argument

  • Build and restart errors

    Solved
    3
    1 Votes
    3 Posts
    99 Views
    phenomlabP

    @baris Thanks - that's a good point actually. I might have some custom CSS or something in the headers that points to that. I'll check.

    EDIT: That was it. Removed that folder and subfolders, and we're good 🙂

  • 503 Errror on Production, OAuth2 callback not working

    Unsolved
    4
    0 Votes
    4 Posts
    166 Views
    J

    @julian said in 503 Errror on Production, OAuth2 callback not working:

    which in Docker might be exposed somewhere...

    docker logs

    Link Preview Image View container logs

    Learn how to write to, view, and configure a container's logs

    favicon

    Docker Documentation (docs.docker.com)

  • 0 Votes
    58 Posts
    2k Views
    julianJ

    Yes thank you

  • 0 Votes
    2 Posts
    123 Views
    PitaJP

    What version of NodeBB?

    You should see the relevant error in the output log. You should be able to capture the message by running ./nodebb log and then trying the test email.

    Have you tried the same SMTP settings in a separate email client?

  • 3.6.0 Upgrade Support

    25
    3 Votes
    25 Posts
    979 Views
    yasasY

    @baris Perfect. Thanks very much for clarifying!

  • Is it possible to customize the privacy consent form?

    Unsolved
    4
    0 Votes
    4 Posts
    151 Views
    Jon PincusJ

    @julian Thanks much, I'll give that a try!

  • Slug translation ?

    4
    0 Votes
    4 Posts
    2k Views
    jsmithJ

    can we do slug translation now? (since it has been many updates)

  • 1 Votes
    13 Posts
    579 Views
    nhl.plN

    You can experiment with some other guides and projects.

    As you probably seen before:

    Docker

    favicon

    (hub.docker.com)

    One more option is to make your own modified Dockerfile. For example Nobbic works on Alpine Linux based Docker images and most of the NodeBB guides are Ubuntu/Debian based. So first thing is to check the host machine/hosting provider and what is going on when you execute Dockerfile. Including Docker version which was mentioned many times on this forum.