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 14.04 or similar. If you’re not using Linux, then you might try running BigchainDB with Docker.

A. Install RethinkDB Server

B. Open a Terminal and run RethinkDB Server with the command:


C. Ubuntu 14.04 already has Python 3.4, so you don’t need to install it, but you do need to install a couple other things:

sudo apt-get update
sudo apt-get install g++ python3-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 and run BigchainDB:

bigchaindb -y configure
bigchaindb start

That’s it!

For now, you can get a good sense of how to work with BigchainDB by going through the examples in the section on the Python Server API.