Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

4.8k Topics 26.7k 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. [image: youtubelogo.png] Setting up SendGrid mailer for NodeBB
  • NodeBB guides, how-to's and general tips and tricks

    83 Topics
    601 Posts
    Z
    not sure the plugin worked for firefox. saw a-z in the sort icon. when i used it, i expected the topics in the category would be sorted a-z. they werent
  • 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.
  • 3.9.0 Upgrade Support

    Pinned
    6
    2 Votes
    6 Posts
    293 Views
    N
    Are there any known issues with creating child/using themes with 3.9.0? I assume after a new update, themes are not always updated at the same time?
  • 3.8.0 Upgrade Support

    Pinned
    36
    2 Votes
    36 Posts
    2k Views
    barisB
    After you get latest code from github you can run ./nodebb upgrade it should install the dependencies update your package.json and run any schema upgrades. It also runs ./nodebb build
  • Issues Integrating My Website’s Login System with NodeBB SSO Plugin

    Unsolved
    1
    0 Votes
    1 Posts
    18 Views
    Ben StokesB
    Hi NodeBB Community, I’m trying to integrate my website’s custom login system with NodeBB using the SSO plugin, but I’m running into issues during the authentication process. Users are redirected correctly to the login page, but after entering their credentials, they’re not being logged into NodeBB, and no session is created. Here’s what I’ve done so far: Configured the SSO plugin with my website’s API endpoints for login and user verification. Ensured CORS is properly configured on the website’s backend. Tested the API endpoints independently and they return the correct user data. Could this be an issue with the plugin’s callback URL or how the session tokens are being handled? Any tips on troubleshooting SSO integrations with NodeBB would be greatly appreciated! Thanks in advance!
  • lot of memory consumption for nodebb

    Unsolved
    26
    0 Votes
    26 Posts
    447 Views
    phenomlabP
    @DownPW did you rebuild the emoji from the plugin options? [image: 1731544365116-1000011453.jpg] Then you need to rebuild and restart nodebb
  • 0 Votes
    6 Posts
    346 Views
    trwnh@mastodon.socialT
    @julian with AP C2S it would be as """simple""" as logging in with your AP actor then when you make a post it gets POSTed to your outbox by nodeBB as an AP Client.unfortunately we do not have widespread support for C2S publishing of activities, so the next best thing is local accounts represented by local actors but logged into with remote credentials (via oidc/fedcm most likely)
  • Login first time

    Solved
    7
    0 Votes
    7 Posts
    59 Views
    S
    Interestingly I asked ChatGPT to check the nginx config and it gave me a new one that seems to have solved both problems. No idea what was wrong, but thank you very much for your help!
  • 0 Votes
    3 Posts
    43 Views
    hay enchH
    @baris I use the latest version of nodebb After a night of investigation I think it is probably a problem related to a failed database migration so I fixed it by redeploying mongodb
  • Tracking Categories/Topics

    Solved
    3
    0 Votes
    3 Posts
    45 Views
    T
    @baris gotcha! I got it working after deleting the template. Thank you!
  • Resized images

    Unsolved
    14
    0 Votes
    14 Posts
    407 Views
    phenomlabP
    @julian not fixed it seems - see https://sudonix.org/topic/418/v3-harmony-diary-thoughts-code-snippets/41?_=1731000122082 [image: 1731000266638-8d8bba5f-b8c9-4888-9b0b-85fe587e61b5-image.png] As you can see below [image: 1731000409529-3799bd7f-ed0d-4f9c-8205-4de2f48a3450-image.png] Removing "resized" makes the image show, but not if left as is.
  • Cannot see attach picture icon on iphone

    Unsolved
    4
    0 Votes
    4 Posts
    297 Views
    phenomlabP
    Why tilt the phone when you can use the scrollbar that should appear under the toolbar in the mobile composer meaning you simply scroll across in order to find what you need?
  • Widget layout issue?

    Unsolved
    10
    0 Votes
    10 Posts
    191 Views
    TapuzHT
    thanks!!
  • Unexpected letter "s" on top of Latest Users widget

    Solved
    3
    0 Votes
    3 Posts
    38 Views
    TapuzHT
    @baris oh alright thanks alot. that's great help
  • Database aborted error

    Unsolved
    2
    0 Votes
    2 Posts
    25 Views
    barisB
    If you post the error message you get, you might get more help.
  • How to change email via API?

    Solved
    4
    0 Votes
    4 Posts
    95 Views
    Brutus5000B
    That works. Thank you!
  • I can't Upload a file to a specific post via API

    Unsolved
    3
    1 Votes
    3 Posts
    268 Views
    C
    @julian hey, i am trying to use upload file api but i am not able consume it. It says forbidden 403 but is working fine in postman. What could be the reason. Thank you so much for your efforts
  • What are NodeBB minimum requirements?

    Unsolved
    5
    0 Votes
    5 Posts
    123 Views
    B-738B
    Upgrade MongoDB from 7.014 to 8.X all perfect and faster! So now I use : Vultr Cloud Compute OS FreeBSD 14.1 DataBase MongoDB 8.0 NodeJS v20.10.X NPM last one PM2 Best proxy SSL server Caddy GoLang tech-с: EG328-RIPE
  • Cover photo / Profile photo not changing on upload

    7
    0 Votes
    7 Posts
    595 Views
    J
    @baris said in Cover photo / Profile photo not changing on upload: Seems to be hard coded here. Which file type are you uploading? Have not had time to look into it and modify, but yeah just was noticing since jpg listed but jpeg wasnt on that file extension list so it wouldnt show the image in the folder.
  • nodebb-plugin-emailer-sendgrid not sending emails

    Unsolved
    5
    0 Votes
    5 Posts
    133 Views
    R
    You shouldn't need SMTP for the sendgrid mailer. It uses the sendgrid API to send mail messages, and optionally, allows for an inbound webhook to receive messages. Have you looked at the activity logs in the sendgrid console to verify that your requests are being handled? If needed, you can add a console log to the Emailer.send method in the nodebb-plugin-emailer-sendgrid index.js file if you want to debug the message handling.
  • nodebb-plugin-reactions slow after selecting

    Moved
    15
    0 Votes
    15 Posts
    347 Views
    phenomlabP
    @julian yes. Seems they are being called even if not actually requested.
  • Raw file downloads

    Solved
    3
    0 Votes
    3 Posts
    83 Views
    D
    @julian Thanks for the reply. I was able to solve it quickly adding it. For anyone in the future, hosting nodebb on a windows server, may also have the same problem. This is how I fixed it <outboundRules> <rule name="ForceFileDownload" preCondition="IsXMLorJSON"> <match serverVariable="RESPONSE_Content-Disposition" pattern=".*" /> <action type="Rewrite" value="attachment; filename={R:0}" /> </rule> <preConditions> <preCondition name="IsXMLorJSON"> <add input="{URL}" pattern="\.xml$|\.json$" /> <add input="{URL}" pattern="^/assets/uploads/" /> </preCondition> </preConditions> </outboundRules>