NodeBB requires the following software to be installed:
- Node.js (version 0.10 or greater, instructions below).
- Redis (version 2.6 or greater, instructions below) or MongoDB (version 2.6 or greater).
- nginx (version 1.3.13 or greater, only if intending to use nginx to proxy requests to a NodeBB server).
Sign in your Joyent account: Joyent.com
Create the newest
Note: The following steps have been tested with images:
smartos nodejs 13.1.0
smartos nodejs 13.2.3
Wait for your instance to show
Runningthen click on its name.
Loginand admin password. If the
Credentialssection is missing, refresh the webpage.
SSH into your server as the admin not root:
Note: For Windows users that do not have ssh installed, here is an option: Cygwin.com
Install NodeBB’s software dependencies:
$ sudo pkgin update $ sudo pkgin install scmgit nodejs build-essential ImageMagick redis
If any of those failed to install then:
$ pkgin search *failed-name* $ sudo pkgin install *available-name*
If needed setup a redis-server with default settings as a service (automatically starts and restarts):
If you want to use MongoDB, LevelDB, or another database instead of Redis please look at the Configuring Databases section.
Note: These steps quickly setup a redis server but do not fine-tuned it for production.
Note: If you manually ran
redis-serverthen exit out of it now.
$ svcadm enable redis $ svcs svc:/pkgsrc/redis:default
Note: If the STATE is maintenance then:
$ scvadm clear redis
- To shut down your redis-server and keep it from restarting:
$ scvadm disable redis
- To start up your redis-server and have it always running:
$ scvadm enable redis
Move to where you want to create the nodebb folder:
$ cd /parent/directory/of/nodebb/
Clone NodeBB’s repository (you may replace the ending nodebb with a different folder name):
$ git clone -b v1.x.x https://github.com/NodeBB/NodeBB.git nodebb
- To track the latest weekly build of NodeBB, substitute weekly in place of v1.x.x.
Install NodeBB’s npm dependencies:
$ cd nodebb $ npm install
Run NodeBB’s setup script:
$ ./nodebb setup
URL used to access this NodeBBis either your public ip address from your ssh
Loginor your domain name pointing to that ip address.
Port number of your NodeBBis the port needed to access your site:
Note: If you do not proxy your port with something like nginx then port 80 is recommended for production.
Please enter a NodeBB secret- Do not email this or post publicly.
IP or Hostname to bind to- Use default unless your server requires otherwise.
If you used the above steps to setup your redis-server then use the default redis settings.
- Start NodeBB process manually:
Note: This should not be used for production but instead create a deamon manually, use Forever, or use Supervisor. Take a look at the options here.
$ node app
- Visit your app!
Example: With a port of 4567:
Note: With port 80 the
:80does not need to be entered.
Note: If these instructions are unclear or if you run into trouble, please let us know by filing an issue.