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.

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

    Solved
    4
    0 Votes
    4 Posts
    116 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
    116 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
    94 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
    104 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
    477 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
    98 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
    158 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
    112 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
    941 Views
    yasasY

    @baris Perfect. Thanks very much for clarifying!

  • Is it possible to customize the privacy consent form?

    Unsolved
    4
    0 Votes
    4 Posts
    141 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
    524 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.

  • 0 Votes
    6 Posts
    143 Views
    barisB

    After you link the plugin so its in node_modules, you need to activate it either from the ACP or from the CLI with ./nodebb activate nodebb-plugin-my-plugin

  • 0 Votes
    2 Posts
    65 Views
    barisB

    Topics on the sitemap are filtered here https://github.com/NodeBB/NodeBB/blob/master/src/sitemap.js#L132, unless you gave guests the View deleted posts privilege they shouldn't show up in the sitemap.

    The sitemap is also cached so it would take some time for the entries to disappear from the sitemap.

  • The favicon and other don't update

    Solved
    16
    0 Votes
    16 Posts
    236 Views
    MichaelwuM

    It's still but if I changed a theme it will be Okay.

  • 0 Votes
    23 Posts
    716 Views
    barisB

    That field is passed to https://github.com/expressjs/cors#configuration-options, you might be able to just leave it out If not specified, defaults to reflecting the headers specified in the request's Access-Control-Request-Headers header.

    Did you try changing your url field in config.json to http://127.0.0.1:4567? And change the connection code to also use 127.0.0.1:4567 instead of localhost.

  • Can NodeBB run on NGINX?

    Solved
    3
    0 Votes
    3 Posts
    99 Views
    David SargradD

    @PitaJ Ty!

  • Search user private chats as administrator

    Solved
    4
    0 Votes
    4 Posts
    117 Views
    B

    Thank you both and apologies for the delay!

    I will try them both out.

  • Running NodeBB on multiple VMs?

    Unsolved
    5
    0 Votes
    5 Posts
    281 Views
    B

    @o-o - I was not able to make fly.io work. Unfortunately I don't remember all the details, but effectively fly.io and NodeBB were working under different assumptions as far as local resources were concerned. Upon idle my fly machine would lose track of the fly database, and upon restart it would attempt to restart NodeBB from scratch. Until the idle everything worked fine. But at the end of the day my issue was automatically serving the precompiled Javascript resources that NodeBB presupposes.

    Outsourcing the database to something like S3 might fix the problem. Also, fly.io changes very quickly, and I know others were having the same problems with other frameworks, so they may now have a workaround.