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.

  • Not able to create an account

    5
    0 Votes
    5 Posts
    2k Views
    JenklerJ

    It works fine when in 0.6.x. So it must be a bug in 0.7.x

  • 0 Votes
    9 Posts
    3k Views
    S

    I just pulled the latest commit and it seems to be working now. Yessss, thank you. (ノ´ヮ´)ノ*:・゚✧

  • Installing nodebb on openshift

    11
    0 Votes
    11 Posts
    5k Views
    ahwayakchihA

    Hi,

    It looks like rhc app create nodebb nodejs-0.10 command did not create nodebb directory.

    Please make sure, that you're running commands on your own computer, not through ssh on OpenShift side.

    Try to remove nodebb from your OpenShift account and start from scratch.

    Calling git init may seemed like it helped, but it created local only repository, which was not connected with any of the others (OpenShift, NodeBB and openshift-nodebb). That is why git push origin master did not work - origin remote was not configured.

  • Help with DNS

    5
    0 Votes
    5 Posts
    2k Views
    LeeML

    @nhl-pl and @julian , all is cool as they say, got help from digital ocean and am good to go now, thanks again to you both for helping - the post is here for anyone else that's looking.

    regards, Lee 😁 😃

  • 0 Votes
    5 Posts
    3k Views
    DimD

    Perfect thanks

  • Typo in MongoDB installation

    3
    0 Votes
    3 Posts
    2k Views
    julianJ

    If you install mongo via apt, I believe it is mongod, but via the 10gen repository, it is mongodb

  • 0 Votes
    5 Posts
    2k Views
    limkerL

    A more quick solution:

    Change

    .container-fluid {
    .container-fixed();
    }

    to

    .container-fluid {
    .container;
    }

    in nodebb-theme-vanilla/less/bootstrap/grid.less

  • need help on nginx server block

    8
    0 Votes
    8 Posts
    5k Views
    PakornP

    @aixnr Thanks u 🙂
    It works now

  • 0 Votes
    11 Posts
    4k Views
    MegaM

    @Mega said:

    I'll check that today-tomorrow and will post here.

    aight
    doesn't reproduced anymore on latest

  • BBcode doesn't work on NodeBB v0.7.0-dev.

    6
    0 Votes
    6 Posts
    2k Views
    A

    Hello @julian,

    After I've updated to the latest commits. This issue resolved now. Thanks for your help.

  • User Management - Ban, delete users?

    6
    0 Votes
    6 Posts
    2k Views
    A

    Easy solution would be the old RTFM method? 😛

  • 0 Votes
    3 Posts
    2k Views
    Chengliang XuC

    @baris thank you for your help 😆 . nodebb is a very excited project

  • Number of guests on scaled installs

    5
    0 Votes
    5 Posts
    2k Views
    T

    Thanks @baris !

  • Benchmarking

    6
    0 Votes
    6 Posts
    2k Views
    A

    You can use apache too, but Nginx is a nicer experience.

    Here's the guide for 2.2.xx

  • Group - Adding a group "master" user?

    3
    1 Votes
    3 Posts
    2k Views
    M

    Thanks Julian!
    Mark thread as solved, working as intended, was just looking for this function inside the admin panel instead of the normal user view 😉

  • This topic is deleted!

    Locked
    2
    0 Votes
    2 Posts
    8 Views
  • Real need for better docs for noobs

    40
    1 Votes
    40 Posts
    18k Views
    OrotonO

    @psychobunny is a real superstar, but the community as a whole (users/developers) is real good one. Which is why I personally would stay with NodeBB over say Discourse, which I would say would be NodeBB's only real competitor.

  • 0 Votes
    5 Posts
    3k Views
    julianJ

    Feel free to add a pull request for this if you haven't already 🙂

  • Using templates/partials, some examples, etc.

    Moved
    1
    3 Votes
    1 Posts
    1k Views
    T

    I believe you should have as many partials in your main template as efficiently as possible to cut down on redundant code. Here I'll write the standard for a good rule of thumb on how you should organize your templates and all the code within in them.

    Any redundant JS scripts should be in their own partial to be reused in other templates if need be.

    Take full advantage of the NBB API so that you extend your template even further. For example using <!-- IF loggedIn --> condition can greatly improve UX and conversions rates on your site. Having some type of call to action or banner within these will let the user know that they aren't logged. OR when they are logged in, show something else. You can come up with some pretty crafty ideas. But yeah, do what you can with the existing API.

    You can only do so much with the templates but is that good enough? Maybe, maybe not, but it does work when you plan out the logical flow and hopefully not get lost in the div's and such. For example on the Majestic Theme, the topic covers are pretty complex and one can easily get lost in the flow of what's going on. Here's a screenshot of the topics UI.

    Screen Shot 2015-03-17 at 8.12.29 AM.png

    Now lets take a little peek at whats under the hood;

    Screen Shot 2015-03-17 at 8.16.46 AM.png

    Screen Shot 2015-03-17 at 8.14.33 AM.png

    Now there's way more to this, but this is just a little example of how I control the topic covers. The only reason why I'm posting this is because I'm quite certain it would take a while to replicate without all of the other partials in this one template (not shown for obvious reasons).

    You can also do stuff like this to take control over pluralization of your template: post<!-- IF !topics.unreplied -->s<!-- ENDIF !topics.unreplied -->
    Which would mean, if you don't have any posts, remove the s in post, otherwise its posts. Neat huh?

    Anyone else have any cool things they've done with the template system so far in their existing theme? Share some of your ideas here. 🙂

  • 0 Votes
    5 Posts
    2k Views
    R

    In the end, here are the only changes (to the original theme) I did to successfully achieve what I wanted without bug:

    Change container to container-fluid in header.tpl to set the "default" format to fluid. For each page that I want to be non-fluid, wrap the whole ***.tpl into a <div class="container"></div>.
    For example I did this for category.tpl, topic.tpl, register.tpl and login.tpl.

    It works.