Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

4.9k Topics 27.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. [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.
  • v4.0.0 Upgrade Support

    Pinned
    17
    4 Votes
    17 Posts
    569 Views
    julianJ
    @cagatay I think so. If A follows B, then B sends stuff to A, but A doesn't send stuff to B.
  • 3.12.0 Upgrade Support

    Pinned
    23
    0 Votes
    23 Posts
    2k Views
    eeeeeE
    @phenomlab Thanks for your advice and help as always, its working now with fastmail, with your custom set up and the app password
  • NodeBB v4.0.0 - Categories not following group actors

    Unsolved
    7
    +0
    1 Votes
    7 Posts
    130 Views
    projectmoonP
    @[email protected] can you share a link to it?
  • Is federation possible only between selected sites?

    Unsolved
    2
    0 Votes
    2 Posts
    32 Views
    julianJ
    @Kosiak Sure thing, v4 shipped with allow/deny lists so you can specify which domains to add to that list. In your case, you'd be using an allow-list. The same limitations to the content sharing model still apply. Topics and posts won't magically flow between the sites unless follow relationships exist or you set up category syncing.
  • Migration from vbulletin possible?

    Unsolved
    7
    0 Votes
    7 Posts
    138 Views
    julianJ
    Completely understood, that's why it's always been such a sticking point. We have some migrators available, but it's not always as easy as running a script and coming back to a NodeBB-compatible DB. There are always some thorny edge cases that crop up over and over again. Unfortunately we're not quite there yet, but perhaps we can get part of the way by consuming an ActivityPub actor's outbox? hmm... food for thought
  • How to hace nice URLs?

    Unsolved
    20
    1 Votes
    20 Posts
    369 Views
    D
    @julian how will this issue with the urls with accents and Ñ ñ affect the federated content and urls?
  • NodeBB v4.0.0 can't see /world

    3
    0 Votes
    3 Posts
    64 Views
    FrankMF
    why didn’t I think of that myself? Thank you @[email protected] and thank you for this release
  • Is it possible to redirect users to root after login?

    Unsolved
    20
    1 Votes
    20 Posts
    197 Views
    D
    @baris new info. when registering an user from /login it gets redirected to the profile instead of going to the root. I mean, share the link to register as "Forum.example/login" instead of sharing the root.. Is it possible this is related? Is this something that can be changed? Thanks Edit: I have not tried yet, but maybe if I share the url with login and then login from there, I go to the profile instead of getting back into the root? Did you try that @baris?
  • This navigation, how to increase. I'm a newbie

    Unsolved
    1
    +0
    1 Votes
    1 Posts
    62 Views
    A
    [image: 1737103598023-screenshot-1737103576996.png] This navigation, how to increase. I'm a newbie
  • 1 Votes
    2 Posts
    65 Views
    julianJ
    @abc123 if you are unable to install NodeBB on your own I'd recommend using a hosted service (like manage.nodebb.org)
  • Search is not working

    Solved
    8
    1 Votes
    8 Posts
    123 Views
    PilleP
    Thanks, now the testing can start with my testers. a not working search would have been a show stopper. Thanks for your input.
  • I can't install NodeBB

    Unsolved
    9
    +0
    2 Votes
    9 Posts
    161 Views
    <baris>B
    @xiaoye looks like an issue with the template engine and strings that start with @key and @value. I've created an issue here, in the meantime I will make some changes in core so an error like that widget doesn't prevent the page from rendering.
  • Some general help with NodeBB

    Unsolved
    9
    1 Votes
    9 Posts
    94 Views
    Astro WhatA
    @Developer.this said in Some general help with NodeBB: So the plugins are OK yet there is one specific plugin that prevents the save function? That was what I ran into. It may have involved the plug-in load order, but the ones I had installed were not need to haves, but want to play withs. @Developer.this said in Some general help with NodeBB: the google SSO does work after i added the .env vars manually Sounds like something is interfering then as I did not need to do the environmental variables.
  • Please help me, I can't install

    Locked Unsolved
    51
    0 Votes
    51 Posts
    836 Views
    Astro WhatA
    There is no "click a button and install" option available AFAIK. But there is fantastic Ubuntu installation documentation available on this site itself (then centOS one is lacking sadly but I may grab another VSP to play with AlmaLinux and NodeBB on). https://docs.nodebb.org/installing/os/ubuntu/ You do have to be familiar with working on the command line of Linux (like in the old days of DOS) as it does make some assumptions about the knowledge level of the installer. If you aren't, then it will be difficult for you to even with cut & paste use as you will probably run into issues. And if you aren't, then it will probably be difficult to keep the site up and running. If someone has gotten it up and running for you, it is your job to keep it running usually. Most people are not going to volunteer to maintain your VPS instance for you. That is usually a paid option with many VPS providers. If you are not familiar with Linux, I encourage you to install it on spare PC (if you have one) to play with, or if you have a decent PC for use then install Oracle VirtualBox on it and set up a Ubuntu instance in it. I do encourage you to use Ubuntu 24.04LTS if your CloudPanel offers it as an install option. It has a longer period before it is no longer supported than 22.04LTS has (04/2027) vs 04/2029). It also has a longer support cycle than 22.04LTS has (12 years vs 10 years).
  • Hover Cards - nodebb-plugin-cards

    Solved
    27
    +0
    0 Votes
    27 Posts
    4k Views
    DownPWD
    ohhhh many thanks
  • Amazon SES doesn't send mail

    Solved
    4
    +1
    0 Votes
    4 Posts
    87 Views
    Astro WhatA
    Just to mention, I think Amazon SES blocks sending on port 25 by default. They advise you to use 587 and StartTLS instead. If you have to use port 25 you are required to submit a request for them to allow it for you. I ran into that on helping a Xenforo admin that was wanting to use SES and was insistent that port 25 was what they wanted to use for some unknown reason.
  • What does @nodebb location does?

    Solved
    5
    0 Votes
    5 Posts
    67 Views
    D
    Replying to myself, this is required when using additional locations for static files.
  • Docker build issue

    Unsolved
    1
    0 Votes
    1 Posts
    47 Views
    F
    Hello friends, I am facing a big issue that is blocking me with Nodebb I tried building NodeBB using the postgress configuration with docker but I am getting this issue. I really don't know what is happening. The .docker/build folder is empty and is not generating nothing. I tried in Windows and in MacOS. The error is the same. Could somebody help me please? This issue is blocking me a lot. PD: I am using the code from github, not a modify version by me. Thanks for your help! nodebb-1 | 2025-01-08T23:33:41.761Z [4567/86] - info: 🎉 NodeBB Ready nodebb-1 | 2025-01-08T23:33:41.762Z [4567/86] - info: 🤝 Enabling 'trust proxy' nodebb-1 | 2025-01-08T23:33:41.763Z [4567/86] - info: 📡 NodeBB is now listening on: 0.0.0.0:4567 nodebb-1 | 2025-01-08T23:33:41.763Z [4567/86] - info: 🔗 Canonical URL: http://localhost nodebb-1 | 2025-01-08T23:33:42.063Z [4567/86] - error: uncaughtException: ENOENT: no such file or directory, open '/usr/src/app/build/public/src/service-worker.js' nodebb-1 | Error: ENOENT: no such file or directory, open '/usr/src/app/build/public/src/service-worker.js' nodebb-1 | at async open (node:internal/fs/promises:638:25) nodebb-1 | at async readFile (node:internal/fs/promises:1242:14) nodebb-1 | at async Controller.generate (/usr/src/app/src/controllers/service-worker.js:13:19) {"date":"Wed Jan 08 2025 23:33:42 GMT+0000 (Coordinated Universal Time)","error":{"code":"ENOENT","errno":-2,"path":"/usr/src/app/build/public/src/service-worker.js","syscall":"open"},"exception":true,"os":{"loadavg":[0.49,0.49,0.29],"uptime":8437.17},"process":{"argv":["/usr/local/bin/node","/usr/src/app/app.js"],"cwd":"/usr/src/app","execPath":"/usr/local/bin/node","gid":1001,"memoryUsage":{"arrayBuffers":714282,"external":4294458,"heapTotal":94744576,"heapUsed":64312264,"rss":192311296},"pid":86,"uid":1001,"version":"v22.13.0"},"stack":"Error: ENOENT: no such file or directory, open '/usr/src/app/build/public/src/service-worker.js'\n at async open (node:internal/fs/promises:638:25)\n at async readFile (node:internal/fs/promises:1242:14)\n at async Controller.generate (/usr/src/app/src/controllers/service-worker.js:13:19)","trace":[{"column":25,"file":"node:internal/fs/promises","function":"async open","line":638,"method":null,"native":false},{"column":14,"file":"node:internal/fs/promises","function":"async readFile","line":1242,"method":null,"native":false},{"column":19,"file":"/usr/src/app/src/controllers/service-worker.js","function":"async Controller.generate","line":13,"method":"generate","native":false}]} nodebb-1 | 2025-01-08T23:33:42.063Z [4567/86] - error: Error: ENOENT: no such file or directory, open '/usr/src/app/build/public/src/service-worker.js' nodebb-1 | at async open (node:internal/fs/promises:638:25) nodebb-1 | at async readFile (node:internal/fs/promises:1242:14) nodebb-1 | at async Controller.generate (/usr/src/app/src/controllers/service-worker.js:13:19) nodebb-1 | 2025-01-08T23:33:42.063Z [4567/86] - info: [app] Shutdown (SIGTERM/SIGINT/SIGQUIT) Initialised. nodebb-1 | 2025-01-08T23:33:42.064Z [4567/86] - info: [app] Web server closed to connections. nodebb-1 | 2025-01-08T23:33:42.071Z [4567/86] - info: [app] Live analytics saved. nodebb-1 | 2025-01-08T23:33:42.072Z [4567/86] - info: [app] Database connection closed. nodebb-1 | 2025-01-08T23:33:42.072Z [4567/86] - info: [app] Shutdown complete. nodebb-1 | [cluster] Child Process (86) has exited (code: 1, signal: null) nodebb-1 | [cluster] Spinning up another process... nodebb-1 | 2025-01-08T23:33:42.201Z [4567/118] - info: Initializing NodeBB v4.0.0-rc.4 http://localhost nodebb-1 | 2025-01-08T23:33:42.684Z [4567/118] - warn: [cache-buster] could not read cache buster ENOENT: no such file or directory, open '/usr/src/app/build/cache-buster' {"code":"ENOENT","errno":-2,"path":"/usr/src/app/build/cache-buster","stack":"Error: ENOENT: no such file or directory, open '/usr/src/app/build/cache-buster'\n at async open (node:internal/fs/promises:638:25)\n at async Object.readFile (node:internal/fs/promises:1242:14)\n at async read (/usr/src/app/src/meta/cacheBuster.js:31:18)\n at async Configs.init (/usr/src/app/src/meta/configs.js:90:17)\n at async start.start (/usr/src/app/src/start.js:19:3)","syscall":"open"} nodebb-1 | 2025-01-08T23:33:42.953Z [4567/118] - info: [socket.io] Restricting access to origin: http://localhost:* nodebb-1 | 2025-01-08T23:33:43.011Z [4567/118] - info: [api] Adding 0 route(s) to `api/v3/plugins` nodebb-1 | 2025-01-08T23:33:43.019Z [4567/118] - info: [router] Routes added nodebb-1 | 2025-01-08T23:33:43.025Z [4567/118] - info: 🎉 NodeBB Ready nodebb-1 | 2025-01-08T23:33:43.026Z [4567/118] - info: 🤝 Enabling 'trust proxy' nodebb-1 | 2025-01-08T23:33:43.027Z [4567/118] - info: 📡 NodeBB is now listening on: 0.0.0.0:4567 nodebb-1 | 2025-01-08T23:33:43.027Z [4567/118] - info: 🔗 Canonical URL: http://localhost
  • NodeJS version upgrade or not?

    Solved
    3
    0 Votes
    3 Posts
    80 Views
    D
    @baris Thanks!!
  • How can I modify content of list posts at profile page?

    Unsolved
    2
    +1
    0 Votes
    2 Posts
    56 Views
    <baris>B
    You will have to modify the template for that page which is at https://github.com/NodeBB/nodebb-theme-harmony/blob/main/templates/account/posts.tpl, keep in mind you that page is showing posts and you want to change them to show as topics so you will have to add make changes to the data as well, possibly using the hook filter:account/posts.build