My attempt to use NodeBB could be largely attributed to the simplicity of its install instructions. Yet I ended up spending much more time fixing all kinds of install problems. :joy: So this post serves as a hint for someone who runs into a similar situation.
Installing MongoDB
brew install mongodbMongoDB can be easily installed on Mac OS using brew.
But after that, I found myself fail to login with terminal.
$ mongo
MongoDB shell version: 3.2.4
connecting to: test
2016-04-19T16:46:45.522+0800 W NETWORK [thread1] Failed to connect to 127.0.0.1:27017, reason: errno:61 Connection refused
2016-04-19T16:46:45.524+0800 E QUERY [thread1] Error: couldn't connect to server 127.0.0.1:27017, connection attempt failed :
connect@src/mongo/shell/mongo.js:224:14
@(connect):1:6Accoding to StackOverflow, this is because mongodb service is not running. And it worked after the following instruction.
brew services start mongodbConnect NodeBB with MongoDB
Create a user in MongoDB
As NodeBB install instructions states, the interactive installation is available with:
./nodebb setupWell, it failed and gave the following error message:
error: NodeBB could not connect to your Mongo database. Mongo returned the following error: Authentication failed.I don’t know the default username and password of my MongoDB. So I created a new user and fixed this problem.
db.createUser({user:'username', pwd:'password', roles:[{role:'readWrite', db:'db-name'}]})Before that, I also created a database called db-name by using use db-name. But this procedure is unnecessary, which I will explain later.
You don’t have to create the database
After that, I ran into the following error message:
/Users/baidu/Workspace/NodeBB/src/database/mongo.js:141
db.objects.dropIndex({_key:1, value: -1});
^
SyntaxError: Unexpected token ;
at exports.runInThisContext (vm.js:53:16)
at Module._compile (module.js:373:25)
at Object.Module._extensions..js (module.js:416:10)
at Module.load (module.js:343:32)
at Function.Module._load (module.js:300:12)
at Module.require (module.js:353:17)
at require (internal/module.js:12:17)
at Object.<anonymous> (/Users/baidu/Workspace/NodeBB/install/databases.js:9:9)
at Module._compile (module.js:409:26)
at Object.Module._extensions..js (module.js:416:10)I searched but found no similar questions, only knowing this concerned with creating something supposed to have unique name.
Yep. That’s why I shouldn’t create the database db-name in MongoDB shell. But this is really weired, right? You need to create a user, but not a database.
NodeBB admin should be the same with that of MongoDB
NodeBB told me to create an admin.
warn: No administrators have been detected, running initial user setup
Administrator username echarts-admin
Administrator email address echarts@baidu.com
Password
Confirm Password I thought this could be different from my MongoDB, but it turned out to be:
warn: NodeBB Setup Aborted.
Error: [[user:change_password_error_length]]
at Object.User.isPasswordValid (/Users/baidu/Workspace/NodeBB/src/user/create.js:193:20)
at async.parallel.passwordValid (/Users/baidu/Workspace/NodeBB/src/user/create.js:165:11)
at /Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:718:13
at async.forEachOf.async.eachOf (/Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:233:13)
at _parallel (/Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:717:9)
at Object.async.parallel (/Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:731:9)
at Object.User.isDataValid (/Users/baidu/Workspace/NodeBB/src/user/create.js:152:9)
at Object.User.create (/Users/baidu/Workspace/NodeBB/src/user/create.js:22:8)
at async.waterfall.adminUid (/Users/baidu/Workspace/NodeBB/src/install.js:275:11)
at fn (/Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:746:34)
at /Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:1213:16
at /Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:166:37
at /Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:706:43
at /Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:167:37
at Object.async.waterfall (/Users/baidu/Workspace/NodeBB/node_modules/async/lib/async.js:710:44)
at success (/Users/baidu/Workspace/NodeBB/src/install.js:273:10)This could be fixed by using the same username and password of your MongoDB user.
Conclusion
All these steps are described by NodeBB as:
Run interactive installation:
./nodebb setup
You may leave all of the options as default.
You know what, this is how you teach someone to draw a horse:
Just kidding… I love NodeBB! :heart_eyes:
