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
    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.

  • NodeBB New Users Overwriting Existing UserIDs

    4
    0 Votes
    4 Posts
    572 Views
    SoarinS

    Thank you all for the responses and offering your time, I completely wiped the nodebb db in MongoDB and re-restored it and everything is functioning perfectly again. ☺

  • Shared login between multiple nodebb sites

    6
    1 Votes
    6 Posts
    1k Views
    B

    I never got around to doing anything with it.

    We have a few gaming sites and I wanted to have one userbase between them all.

  • Profile Pictures.

    2
    0 Votes
    2 Posts
    424 Views
    PitaJP

    It's likely that this is a bug, not something you can easily fix. Open an issue on GitHub.

  • Killed... Killed and Killed

    7
    0 Votes
    7 Posts
    557 Views
    Dan ReyesD

    Hi, i fixed the problem by reinstalling nodebb. also cleaning all plugins and stuff, and no. I dont have nay custom plugin the only plugin i downloaded before this error was iframely recommended by the admins of this forum.

  • 0 Votes
    2 Posts
    704 Views
    D

    To resolve this, I changed the Proxy module I was using. It uses less code to implement and works with websockets. I think the NodeBB Node.js proxy documentation is out of date so I'll be submitting a PR with the new method I found.

    Working code is as follows:

    /** * Proxy forum */ const proxy = require('http-proxy-middleware'); // Forum Proxy app.use( '/forum', proxy({ target: 'http://www.myforum.co.uk/forum', changeOrigin: true, ws: true, }) );

    Another potential GOTCHA here is that this Prixy setup needs to be declared ABOVE the 'body-parser' module (if it's being used). The wrong order will prevent post requests from being proxied.

  • MongoDB Shard Key?

    1
    0 Votes
    1 Posts
    411 Views
    KryllisK

    I'm looking to use Azure CosmosDB mongoDB API with more than 10GB, so I need a shard key to get unlimited storage. Is there anything I have to do with NodeBB for the shard key?

    Also, I couldn't find this anywhere and have no forum experience, but excluding media, how much storage does a moderate forum take up?

  • 0 Votes
    1 Posts
    244 Views
    ll chenL

    I just try to update the avatar, but it just request timeout error, and shows popup that connections is not ok.

    1.png
    2.png

  • 0 Votes
    2 Posts
    549 Views
    M

    I just tested installation of NodeBB on fresh OS and its working. There have to be something wrong with my OS.

  • How to edit theme?

    2
    0 Votes
    2 Posts
    558 Views
    julianJ

    Here is documentation on starting your own theme: https://docs.nodebb.org/development/themes/

    If you want to make small style changes, it's best to do it in the custom CSS portion of the ACP, instead of editing the theme files directly.

  • 0 Votes
    5 Posts
    609 Views
    julianJ

    Also if you have a package-lock.json, deleting that could be helpful as well.

  • How to search

    4
    0 Votes
    4 Posts
    456 Views
    Jose AntonioJ

    @julian @gotwf Yes, I have reset it and have it rebuilt. But nothing, I think it's something of the template that is not. Where can I edit the theme?

  • 0 Votes
    5 Posts
    264 Views
    julianJ

    You need to be in the actual folder you installed NodeBB in, you can't just run that command anywhere!

  • 0 Votes
    5 Posts
    541 Views
    barisB

    Is your forum public?

  • 504 Gateway Timeout after changing theme.

    3
    0 Votes
    3 Posts
    406 Views
    MineCake PvPM

    There are no error that show. Checked the log from the instance I ran for about 6 hours. It was the theme, though. I did the command given and it worked well. Thank you.

  • Help (Profile pictures)

    1
    0 Votes
    1 Posts
    191 Views
    Dan ReyesD

    I've been waiting for days but i don't get any reply, i tried by googling my issue but same.

    The problem is that members of my forum can't update their profile pictures or banner. They change it but nobody can't see the new picture until they clear caché. How to fix that?

  • 504 Error on /admin/extend/rewards [Solved]

    3
    0 Votes
    3 Posts
    403 Views
    barisB

    0.0.14 should fix this issue.
    https://github.com/NodeBB/nodebb-rewards-essentials/commit/b2a6caaba0447fd0344f9cda4995983f1019e2a2

  • Wheres the documentation for permissions

    2
    0 Votes
    2 Posts
    284 Views
    PitaJP
    _ _ __ __ _______ _ _ _____ _ _ _____ /\ | \ | | \ \ / / |__ __| | | | | |_ _| | \ | | / ____| / \ | \| | \ \_/ / | | | |__| | | | | \| | | | __ / /\ \ | . ` | \ / | | | __ | | | | . ` | | | |_ | / ____ \ | |\ | | | | | | | | | _| |_ | |\ | | |__| | /_/ \_\ |_| \_| |_| |_| |_| |_| |_____| |_| \_| \_____| _ _ _ _ (_) (_) | | | | _ ___ _ __ ___ ___ ___ _ | |__ | | ___ | | / __| | '_ \ / _ \ / __| / __| | | | '_ \ | | / _ \ | | \__ \ | |_) | | (_) | \__ \ \__ \ | | | |_) | | | | __/ |_| |___/ | .__/ \___/ |___/ |___/ |_| |_.__/ |_| \___| | | |_|

    Pretty much anything can be done by a plugin. The hardest part is probably getting the UI to control such permissions in an understandable way.

  • Profile pictures not updating

    3
    0 Votes
    3 Posts
    321 Views
    Dan ReyesD

    @julian yes

  • console: Missing translation

    1
    0 Votes
    1 Posts
    253 Views
    C

    I have upgraded my nodebb to v1.12.2 and I am using apache2 as a proxy (https://docs.nodebb.org/configuring/proxies/apache/) but there is an error in the console saying that translations are missing. I just can see the placeholder strings in my forum (remember_me etc.).

    The translation files are there, inside the public directory of my nodebb installation.

    The problem is that the directory assets does not exist. I tried to set a rewrite condition in the apache2 config file for my forum, in order to rewrite assets for public, but no success. Any help would be very much appreciated.

    UPDATE: ./nodebb log shows me the same Missing translation errors, so I guess it has nothing to do with Apache

    Update 2: I can also view the source of the translation files from the link prefetch.

    Update 3: it seems like it is only an issue when I am logged in as a user in my nodebb installation

    Update 4: the issue with only with the current admin user, and for some reason the language setting for this user, after updating nodebb, was set to a language which was not installed on my system. I set it to en-US and all is good now.

    Here is a screenshot:

    Screen Shot 2019-06-03 at 12.55.16.png

  • 0 Votes
    6 Posts
    1k Views
    PitaJP

    What version of mongodb? Try downgrading to mongo 3.x