The Apache Software Foundation has released CouchDB version 2.0.  CouchDB 2.0, is a “distributed” version of CouchDB, a mature NoSQL, document-oriented data-store that is accessable via a RESTful JSON API. Developers can take advantage of CouchDB’s offline capability and reliable data sync for web, mobile and IoT apps at (any) scale.

[NOTE: September 2017 — CouchDB 2.1 and Raspbian Stretch have been released.  Check out updated instructions in this blog post]

Current Raspbian (November 2016) can “apt-get install” version 1.4 and I have previously written about getting CouchDB 1.6 running on the R-Pi.  I have now installed version 2.0.0 on an R-Pi 3 and am sharing the process.  It is pretty straightforward to get CouchDB 2.0 running on the R-Pi. It takes a combination of the R-Pi specific 1.6 install and the “generic linux” 2.0 install to get things running.


First, make sure your R-Pi is running the latest Raspbian:

sudo apt-get update
sudo apt-get upgrade

On my R-Pi 3, you can see Raspbian and kernel versions:

pi@PiCam-3:~ $ uname -a
Linux PiCam-3 4.4.38-v7+ #938 SMP Thu Dec 15 15:22:21 GMT 2016 armv7l GNU/Linux

pi@PiCam-3:~ $ cat /etc/os-release
PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
NAME="Raspbian GNU/Linux"
VERSION="8 (jessie)"


You should add a CouchDB specific repository and then “apt-get” dependencies:

sudo apt-key add erlang_solutions.asc
sudo apt-get update
sudo apt-get install -y erlang-nox erlang-dev erlang-reltool
sudo apt-get install -y build-essential
sudo apt-get install -y libmozjs185-1.0 libmozjs185-dev
sudo apt-get install -y libcurl4-openssl-dev libicu-dev


Setup the couchdb user:

sudo useradd -d /home/couchdb couchdb
sudo mkdir /home/couchdb
sudo chown couchdb:couchdb /home/couchdb

Get URL to download source for couchdb.  Use a browser to navigate to:  Under “Download CouchDB 2.0.x”, click on “Source” button.  Copy the suggested mirror download URL.  In my case it was:  On the R-Pi, download and unzip source:

tar zxvf apache-couchdb-2.0.0.tar.gz
cd apache-couchdb-2.0.0/
make release


after  a bit, you should see:

... done

    You can now copy the rel/couchdb directory anywhere on your system.
    Start CouchDB with ./bin/couchdb from within that directory.


For convience, I chose to copy the couchdb  directory with executables and configuration files to the couchdb home directory.  Make sure you are in the couchdb directory under the release (rel) directory.  Copy the contents of the …/rel/couchdb to the couchdb home directory.


cd ./rel/couchdb
sudo cp -Rp * /home/couchdb
sudo chown -R couchdb:couchdb /home/couchdb


I want to access CouchDB from other machines and run fauxton in a browser from my Mac.  Fauxton is a web-based interface for CouchDB. Change the local configuration file in “/home/couchdb/etc”.  Either use “vi” or “nano” or your favorite editor to edit “local.ini”


cd /home/couchdb/etc
sudo vi local.ini


Under the chttp section, change this line to enable remote access from any IP address.


#bind_address =


bind_address =


Save and exit the editor.

You should now be able to run CouchDB.  It needs to be run as user: couchdb.

sudo -i -u couchdb /home/couchdb/bin/couchdb


This will display some diagnostic messages and the CouchDB motto: “Relax” 😉

You may see some “shard errors” until you actually write to a DB.  Easiest thing to do is to setup an admin user via Fauxton utility.  Either from a remote machine – I use my Mac – or a local browser on the R-Pi, you can now launch Fauxton.  You need to know your R-Pi’s IP address if running remotely.  My particular R-Pi has the address:  In a browser you can put in the URL:


You should click on the “Verify” button in the left navigation panel and then click “Verify Installation” button at the top of the page.  If everything went well, you should see: