Skip to content

Technical Support

Need help with installing or configuring NodeBB? Look here.

4.7k Topics 26.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.

    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
    196 Posts
    phenomlabP

    @baris updated to 3.7.2 and now just waiting for the plugin to be updated.

  • Optimizing NodeBB for Lower Memory Usage on a 1GB RAM Server

    Unsolved
    4
    2 Votes
    4 Posts
    250 Views
    barisB

    Old Spice Hombre GIF

  • Can't start NodeBB

    Solved
    7
    0 Votes
    7 Posts
    302 Views
    N

    @Michaelwu said in Can't start NodeBB:

    solved! I del node accidentally

    🤣

  • 0 Votes
    2 Posts
    3k Views
    julianJ

    @arizona Ubuntu 18.04 is now out of support, best recommendation now is to upgrade your OS.

  • Unable to change another user's email via ACP

    Solved
    3
    2 Votes
    3 Posts
    156 Views
    B

    @baris Ah ok thanks, I will give it a try next time this comes up (I used the API this time).

  • Categories not showing up when trying to move topics

    Unsolved
    5
    0 Votes
    5 Posts
    232 Views
    dave1904D

    I was able to fix the problem, a CSS rule I created hid the categories. A bit embarrassing but that's how it is. Sorry for the trouble and thanks for the effort!

  • 0 Votes
    8 Posts
    1k Views
    MichaelwuM

    Ok. Sorry for that. I searched the posts and trying out.. That's the error in config.json

  • how to persist uploaded files with docker deployment?

    Solved
    3
    0 Votes
    3 Posts
    180 Views
    N

    By default, admin management panel can be used to upload favicon/site-logo and etc images which are not hooked in the nodebb original source code.

    image.png

    If that's the situation you have to override the default upload behavior, you may have to change the source code. I'll put a simple example below:

    source code to change: src/controllers/admin/uploads.js for example, override the default uploadFavicon behavior with the above plugin: uploadsController.uploadCategoryPicture = function() { await upload('favicon', req, res, next); }
  • Private messaging?

    Unsolved
    2
    0 Votes
    2 Posts
    66 Views
    N

    I can't seem to find much on how to have or enable private messaging between users with optional email alerts.

    Is there such a thing? I don't even see a chat option but I've read there is a built in one. Not sure what I'm not seeing so thought I should ask.

  • Group Badge Not Showing

    Solved
    14
    0 Votes
    14 Posts
    432 Views
    barisB

    I believe if a user joins a group and their groupTitle field is not set yet then they will automatically get that groups title. https://github.com/NodeBB/NodeBB/blob/master/src/groups/join.js#L93-L108

  • NodeBB 3.3.8 Crashes on User Mention in Public Chat

    Solved
    5
    1 Votes
    5 Posts
    230 Views
    tankerkiller125T

    @baris Thanks, updated and everything is working now.

  • What should persist for docker installs?

    Unsolved
    2
    1 Votes
    2 Posts
    308 Views
    N

    ./public/uploads/ should be persist, it's used for the uploaded files.

    By the way, how do you handle the persist problem in docker?

  • widgets settings lost/reset after choosing another theme

    Solved
    3
    0 Votes
    3 Posts
    136 Views
    N

    @PitaJ Thanks.🤝🤝

  • 3.3.0 Upgrade Support

    81
    0 Votes
    81 Posts
    6k Views
    dave1904D

    @DownPW I can confirm this, same issue and solution

  • Loading JS/JQuery in Extend > Widgets

    Solved
    10
    0 Votes
    10 Posts
    340 Views
    T

    @baris said in Loading JS/JQuery in Extend > Widgets:

    <script type="text/javascript">
    (function() {
    function myWidgetCode() {
    $('#someElement').text('jquery should work here!');
    }
    if (document.readyState === 'loading') {
    document.addEventListener('DOMContentLoaded', myWidgetCode);
    } else {
    myWidgetCode();
    }
    })();
    </script>

    I just tried and it works perfectly! Thank you!

  • Hide Code

    Unsolved
    3
    0 Votes
    3 Posts
    183 Views
    julianJ

    @PitaJ I imagine this would be used for some code sharing site where you need to be a member to view.

    Anyway, this can be done via custom plugin listening on the parse hooks. You can remove code blocks there and insert a block asking users to log in 🤷

    @Konrad-Gierej-0 Are you developing this yourself?

  • Manually setting vote count for posts

    Unsolved
    19
    0 Votes
    19 Posts
    538 Views
    R

    Thanks, that works perfectly. I'm handling the hook in my custom theme, but this probably needs to be in the https://community.nodebb.org/post/95161 plugin as well (without the importedVotes)

    library.setTopicVotes = async function(hookData) { const topicData = await topics.getTopicFields(hookData.post.tid, ['cid', 'importedVotes']); const importedVotes = topicData.importedVotes || 0 const voteData = await db.getSortedSetRangeByScoreWithScores(`tid:${hookData.post.tid}:posts:votes`, 0, -1, 1, '+inf'); let allvotes = voteData.reduce((acc, cur) => acc + cur.score, 0); allvotes = allvotes + importedVotes await db.sortedSetAdd(`cid:${topicData.cid}:tids:votes`, allvotes, hookData.post.tid) }
  • 0 Votes
    4 Posts
    476 Views
    barisB

    @sivaprakash-ramasamy as far as I know there is no easy way to increase that limit in MongoDB.

    What is the key that is storing 16mb? Can you change it to use a sorted set instead?

  • Styling Tooltips in Harmony Theme

    Solved
    3
    0 Votes
    3 Posts
    126 Views
    T

    @baris Cool! Giving this a shot now!

  • Custom Theme is Not in the NPM Registry

    Unsolved
    6
    0 Votes
    6 Posts
    212 Views
    T

    @julian I'm still getting the same error. Do I have to uninstall the custom theme first (It's currently active as the main theme).

    I probably did it the wrong way. I basically copied harmony in node_modules and rename it and did my edits from there.

  • My admin panel is without CSS, how can I fix this?

    Unsolved
    5
    0 Votes
    5 Posts
    231 Views
    Gliding9426G

    Looks like I also misconfigured the proxy server, /assets was pointing to an empty directory (it used to work until i moved it forgetting it was mentioned there)