This page has instructions to set up a single stand-alone BigchainDB node for learning or experimenting. Instructions for other cases are elsewhere. We will assume you’re using Ubuntu 16.04 or similar. If you’re not using Linux, then you might try running BigchainDB with Docker.

A. Install the database backend.

Install RethinkDB Server or Install MongoDB Server 3.4+

B. Run the database backend. Open a Terminal and run the command:

with RethinkDB

$ rethinkdb

with MongoDB 3.4+

$ mongod --replSet=bigchain-rs

C. Ubuntu 16.04 already has Python 3.5, so you don’t need to install it, but you do need to install some other things:

$ sudo apt-get update
$ sudo apt-get install g++ python3-dev libffi-dev

D. Get the latest version of pip and setuptools:

$ sudo apt-get install python3-pip
$ sudo pip3 install --upgrade pip setuptools

E. Install the bigchaindb Python package from PyPI:

$ sudo pip3 install bigchaindb

F. Configure the BigchainDB Server: and run BigchainDB Server:

with RethinkDB

$ bigchaindb -y configure rethinkdb

with MongoDB

$ bigchaindb -y configure mongodb

G. Run the BigchainDB Server:

$ bigchaindb start

That’s it!

Next Steps: You could build valid transactions and push them to your running BigchainDB Server using the BigchaindB Python Driver.