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.

  • Make lavenders avatar a circle

    Moved
    6
    0 Votes
    6 Posts
    3k Views
    A

    This is what I mean, it stays as a square despite putting the css you gave me
    Image

  • Persona: display full name instead of username

    Moved
    2
    1 Votes
    2 Posts
    1k Views
    mechanixM

    Found it 🙂

    Link Preview Image nodebb-theme-persona/templates/partials/topic/post.tpl at master · NodeBB/nodebb-theme-persona

    Persona - A modern and responsive NodeBB theme. Contribute to NodeBB/nodebb-theme-persona development by creating an account on GitHub.

    favicon

    GitHub (github.com)

    change that line to...

    <a href="<!-- IF posts.user.userslug -->{config.relative_path}/user/{posts.user.userslug}<!-- ELSE -->#<!-- ENDIF posts.user.userslug -->" itemprop="author" data-username="{posts.user.username}" data-uid="{posts.user.uid}">{posts.user.fullname}</a>

    Full Name is an optional field so not everybody updates it in their profile. You might want to check if it's available before displaying it.

    <a href="<!-- IF posts.user.userslug -->{config.relative_path}/user/{posts.user.userslug}<!-- ELSE -->#<!-- ENDIF posts.user.userslug -->" itemprop="author" data-username="{posts.user.username}" data-uid="{posts.user.uid}"><!-- IF posts.user.fullname -->{posts.user.fullname}<!-- ELSE -->{posts.user.username}<!-- ENDIF posts.user.fullname --></a>
  • NodeBB on Uberspace

    1
    0 Votes
    1 Posts
    836 Views
    Z

    Dear all,

    as the topic title states I am trying to run a NodeBB forum on the shared hoster Uberspace. I am following the fairly recent guide from Til Zöller. It works fine until I change the user registration to "Admin Invite". Once a user tries to register he gets a registration error with the message

    <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN"> <html><head> <title>502 Proxy Error</title> </head><body> <h1>Proxy Error</h1> <p>The proxy server received an invalid
    response from an upstream server.<br />
    The proxy server could not handle the request <em><a href="/register">POST /register</a></em>.<p> Reason: <strong>Error reading from remote server</strong></p></p> <hr> <address>Apache/2.2.15 (CentOS) Server at xxx.xxx.uberspace.de Port 80</address> </body></html>

    Any help would be highly appreciated.

  • How to customize alert messages?

    3
    0 Votes
    3 Posts
    1k Views
    KD PuvvadiK

    Thanks mate

  • 0 Votes
    7 Posts
    2k Views
    KD PuvvadiK

    yes, i've saved it . but problem still exist, some times shows invalid client id, sometime invalid session id

  • Duplicated topic title

    1
    0 Votes
    1 Posts
    700 Views
    S

    Hi there,

    I have this problem of duplicated title, see image below:
    0_1463568546431_Screen Shot 2016-05-18 at 6.47.14 PM.png

    How do I remove the duplicated topic title?

  • This topic is deleted!

    1
    0 Votes
    1 Posts
    14 Views
  • 0 Votes
    3 Posts
    3k Views
    D

    Well, after that post I went digging in the code. And look what I found:
    https://github.com/NodeBB/nodebb-plugin-composer-default/issues/37
    https://github.com/NodeBB/NodeBB/pull/4621

    That actually fixes my issues. I updated to weekly and everything seems to work nicely. Seems to have also fixed the problem with the websockets. I see no more errors. When can we expect the v1.0.4? 🙂

  • phantom notification count

    Unsolved
    2
    0 Votes
    2 Posts
    779 Views
    julianJ

    Hm, that's quite weird... I know there's some logic in NodeBB that will hide notifications if they do not have a path, though I can't fathom why the notification would re-appear!

    Can you let me know the output of: db.objects.find({ _key: "uid:1:notifications:unread" }); (assuming you're using MongoDB)?

  • Need Help

    Solved
    3
    0 Votes
    3 Posts
    1k Views
    C

    @KyleB Not many recent videos out there. Maybe this will help you?

    Make sure to set video quality higher than 480 for clearer output

  • Getting a 502 error on upload of group cover image

    Solved
    3
    0 Votes
    3 Posts
    1k Views
    V

    Thanks! I updated my site from the master and it now works.

  • Disable/Remove "There are no topics in this category."

    Solved
    3
    0 Votes
    3 Posts
    1k Views
    julianJ

    Thanks @yariplus 😄 will take it under advisement.

  • Search Feature doesnt work

    9
    1 Votes
    9 Posts
    3k Views
    julianJ

    Are you saying the search only works in English?

  • 0 Votes
    2 Posts
    807 Views
    P

    @scen you can ignore that if you want... not an issue or error.

    if you want the warning to go away then, add this to the package.json file in your theme (assuming you are using NodeBB 1.x.x)

    "nbbpm": { "compatibility": "^1.0.0" }
  • All users emails are showing in the view source code mode

    Solved
    5
    0 Votes
    5 Posts
    2k Views
    PilvinenP

    Thank you! That was it. Issue resolved.

  • 0 Votes
    5 Posts
    1k Views
    yariplusY

    @g0st Pushed an update so that the topic cards use the topic thumbnail if available, and added a few extra options in the widget config.

    Feel free to open any other feature requests in the github issues.

  • Question regarding user notification

    1
    0 Votes
    1 Posts
    648 Views
    mechanixM

    Hi,

    just a quick question: does a user gets notified by default via mail if I mention him with @username in a post?

    Thank you

  • Setup failed while upgrading

    6
    0 Votes
    6 Posts
    2k Views
    C

    @Aureney Not sure if it's still the case but according to this it's not compatible with nodebb 1.x.x

    Link Preview Image Not compatible with nodebb 1.0.0 · Issue #17 · ahwayakchih/openshift-nodebb

    Hi, I just tried to upgrade my app and i want to report that its not compatible with nodebb 1.0.0. I got an error remote: This looks like a new installation, so you'll have to answer a few questions about your environment before we ca n ...

    favicon

    GitHub (github.com)

  • wrench deprecated

    Solved
    3
    0 Votes
    3 Posts
    1k Views
    C

    @pichalite good to know, thanks!

  • [edit] No config.json file

    15
    0 Votes
    15 Posts
    4k Views
    A

    @frissdiegurke I know. That's why I started it.