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.

  • Upgrade path

    3
    0 Votes
    3 Posts
    476 Views
    attisA

    @baris Awesome news! Thanks for the swift reply 🙂

  • Hierarchical groups

    1
    0 Votes
    1 Posts
    194 Views
    J

    Hi Developers,

    I filed a feature request recently, asking for hierarchical groups (for the full description see: https://github.com/NodeBB/NodeBB/issues/7410).

    I completely understand this request may not help everyone, and perhaps its not considered something that should be added to the core.

    To that end, does anyone have an idea how to efficiently implement the above in a plugin? I am trying to avoid multiple accesses to the DB, and obviously redundant c/p. How would you go about implementing that?

    Thanks,
    JJ,

  • 0 Votes
    1 Posts
    255 Views
    matamrdM

    Hello all,
    Because of budget issues, I would like to install nodebb on shared hosting only. I have access to shell. I guess I can install if i have access to shell. Could you please say procedure as I can't find anywhere. Namecheap shared hosting uses cloudlinux OS and gives users to access shell

  • ./nodebb upgrade not works

    6
    0 Votes
    6 Posts
    698 Views
    S

    @MJ said in ./nodebb upgrade not works:

    @creatxr

    cd nodebb (or path to where nodebb is installed)
    ./nodebb stop
    git fetch
    git checkout v1.12.x
    git merge origin/v1.12.x
    ./nodebb upgrade

    after upgrade

    ./nodebb start

    I have a "one liner" that I use like this. This is what I do...

    git fetch && git checkout v1.12.x && git pull && ./nodebb stop && npm i && ./nodebb upgrade && npm i && ./nodebb start && ./nodebb log

    I put the version right at the beginning so there is just one place to change it (a script and variable would be better, but I'm lazy.) I do the NPM install manually because it used to fail. Been using the same command since the 0.6.0 days, I'd guess. And I add the log at the end so that if I look away, I always see the log scrolling to know that things are okay.

  • strange login route

    7
    0 Votes
    7 Posts
    591 Views
    W

    I'm having the same issue: https://community.nodebb.org/topic/13753/incorrect-url-after-login

  • Problem site description

    6
    0 Votes
    6 Posts
    679 Views
    Jean-baptiste DevicJ

    What exactly would I have to do ?

  • Can't find setting for Section Text Color

    4
    0 Votes
    4 Posts
    402 Views
    jtsimoesJ

    @dcook The color you want to change is not property of the categories, but rather the property of the theme. Black is the theme color for section categories (non-clickable link) and blue is the theme color for non-section/normal categories (clickable link).
    That's why there is no option to customize it on categories management.

    Try this:

    .title{ color: blue; }
  • Bug in Group property page

    2
    2 Votes
    2 Posts
    364 Views
    jtsimoesJ

    Wow, nice find! It's a really important bug. How I had never tested this before?! 😆

  • Username change back to avatar after upgrade 1.12.x

    Solved
    8
    0 Votes
    8 Posts
    634 Views
    M

    It worked 🙂

    I have now a user icon there instead of avatar 🙂

    45d0aa70-b9e4-4ed7-89c8-a35773cf89e6-image.png

  • Starting with systemd only works as root

    11
    1 Votes
    11 Posts
    884 Views
    W

    I did get this working.
    I moved the nodebb working directory to /home/nodebb/nodebb and changed ownership of that to nodebb:nodebb, now it starts up on boot as the nodebb user just fine.

    Thank you all very much for the help.

  • Mobile Menu Bug

    8
    0 Votes
    8 Posts
    755 Views
    Austin BeneshA

    Solved. I fixed it by changing the theme, rebuild and restart and then change the theme back to original, rebuild and restart.

  • 0 Votes
    3 Posts
    423 Views
    ufan0U

    @jtsimoes You are really nice!

  • This topic is deleted!

    1
    0 Votes
    1 Posts
    18 Views
  • Offline setup

    13
    0 Votes
    13 Posts
    870 Views
    S

    @ofaruksahin said in Offline setup:

    Yeah, you're right. Because my request is not respond 404. It's going slowly and sometimes 504 time out. So what do you suggests me?
    Thank you.

    Start with the DNS. If it is slow and only breaks sometimes, DNS is the most likely thing and might be just slow enough that sometimes it works barely and sometimes it fails. 504 is server side error unable to respond.

    If JS files are trying to be pulled from remote, then DNS has to be used. If DNS is pointing externally, we'd expect the delay. If it works sometimes, that means that there is some sort of fallback that is likely just timing out sometimes.

  • nodebb-plugin-2factor missing menu

    Solved
    2
    0 Votes
    2 Posts
    351 Views
    FrankMF

    Today i updated my forum to v1.12.0 and i found the menu 😉

    22e5d0c9-6aff-4e01-b563-d35b49576801-grafik.png

    I think it works too before the update. A user problem 🙂

    Problem solved.

  • 0 Votes
    2 Posts
    443 Views
    PitaJP

    Try the Ubuntu docs instead of the Debian docs. They're more up to date.

  • How to add a footer?

    3
    0 Votes
    3 Posts
    2k Views
    ufan0U

    domain/admin->extends->widget

  • This topic is deleted!

    2
    0 Votes
    2 Posts
    3 Views
  • [solved] duplicate url when logging in

    Solved
    7
    0 Votes
    7 Posts
    615 Views
    D

    @PitaJ Perfect, that solved it, thank you for the more information, I didn't realize it was referring to the port as well.

    You can mark this as resolved!

  • template.js to benchpress issue.

    10
    0 Votes
    10 Posts
    959 Views
    T

    @yariplus Work! Thanks 🐶