bigchaindb/docs/server/source/dev-and-test/setup-bdb-host.md

Set Up BigchainDB Node on Local Dev Machine

With MongoDB

Create a default BigchainDB config file (in $HOME/.bigchaindb):

$ bigchaindb -y configure mongodb

Note: The BigchainDB CLI and the BigchainDB Configuration Settings are documented elsewhere. (Click the links.)

Start MongoDB 3.4+ using:

$ mongod --replSet=bigchain-rs

You can verify that MongoDB is running correctly by checking the output of the previous command for the line:

waiting for connections on port 27017

To run BigchainDB Server, do:

$ bigchaindb start

You can run all the unit tests to test your installation.

The BigchainDB CONTRIBUTING.md file has more details about how to contribute.

With RethinkDB

Create a default BigchainDB config file (in $HOME/.bigchaindb):

$ bigchaindb -y configure rethinkdb

Note: The BigchainDB CLI and the BigchainDB Configuration Settings are documented elsewhere. (Click the links.)

Start RethinkDB using:

$ rethinkdb

You can verify that RethinkDB is running by opening the RethinkDB web interface in your web browser. It should be at http://localhost:8080/

To run BigchainDB Server, do:

$ bigchaindb start

You can run all the unit tests to test your installation.

The BigchainDB CONTRIBUTING.md file has more details about how to contribute.