Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

4.9k Topics 27.0k 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.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
  • How to hace nice URLs?

    Unsolved
    16
    0 Votes
    16 Posts
    201 Views
    <baris>B
    They are not generated live. If we only apply it to new slugs then you will have tons of slugs in the old format. Not sure if that will lead to other issues.
  • Is it possible to redirect users to root after login?

    Unsolved
    19
    1 Votes
    19 Posts
    91 Views
    D
    Ok. Not true but ok. I suppose you never got any bugs in history. I told you what it was causing it. A config. Probably a bug.
  • This navigation, how to increase. I'm a newbie

    Unsolved
    1
    +0
    1 Votes
    1 Posts
    22 Views
    A
    [image: 1737103598023-screenshot-1737103576996.png] This navigation, how to increase. I'm a newbie
  • 1 Votes
    2 Posts
    36 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
    44 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
    122 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
    63 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
    579 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
    73 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
    52 Views
    D
    Replying to myself, this is required when using additional locations for static files.
  • Docker build issue

    Unsolved
    1
    0 Votes
    1 Posts
    37 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
    63 Views
    D
    @baris Thanks!!
  • How can I modify content of list posts at profile page?

    Unsolved
    2
    +1
    0 Votes
    2 Posts
    48 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
  • Nodebb can't loading a module

    Unsolved
    2
    +1
    0 Votes
    2 Posts
    32 Views
    <baris>B
    If you are adding a new client side js module, you need to define it in your plugin.json see the quickstart plugin https://github.com/NodeBB/nodebb-plugin-quickstart/blob/master/plugin.json#L23
  • Logic datasync Redis and Mongo have issues and solution for high traffic?

    Unsolved
    5
    0 Votes
    5 Posts
    154 Views
    D
    thanks you so much!
  • Version Upgrade Steps from 2.8 to Current

    Solved
    6
    0 Votes
    6 Posts
    82 Views
    J
    Awesome, thanks for the info!
  • Automatically logging in after registration, despite no email verification.

    Solved
    5
    1 Votes
    5 Posts
    67 Views
    <baris>B
    My changes and the local login privilege only applies to regular logins so should be fine.
  • How to deploy with docker compose file using an existing mongodb container?

    Unsolved
    1
    0 Votes
    1 Posts
    40 Views
    Y
    Hello, I found that many examples need start a new mongodb container when installing nodebb. However, I have installed mongodb in a container on my server. I have created a root user and root passward for the mongodb. But I haven't create a database. Then how to install nodebb in this case, what's should be modified in the docker compose file in order to run correctly? Thanks.