CouchDB

HOWTO: Install on OS X

The README file is a little bit incorrect. couchdb needs to be configured with:

lconfigure --with-js-include=/Ports/include/js --with-js-lib=/Ports/lib
--with-erlang=/Ports/lib/erlang/usr/include

HOWTO: Install on Debian/Ubuntu

$ sudo apt-get install build-essential libicu38 libicu-dev libmozjs-dev \
libcurl4-openssl-dev erlang-nox erlang-dev

$ ./configure && make && make install

$ sudo adduser --system --home /usr/local/var/lib/couchdb \
--no-create-home --shell /bin/bash --group \
--gecos "CouchDB Administrator" couchdb

$ sudo chown -R couchdb /usr/local/etc/couchdb

$ sudo chown -R couchdb /usr/local/var/lib/couchdb

$ sudo chown -R couchdb /usr/local/var/log/couchdb

$ sudo touch /usr/local/var/run/couchdb.pid

$ sudo chown couchdb:couchdb /usr/local/var/run/couchdb.pid

Start with:

$ sudo -i -u couchdb couchdb

At this point, the web interface should be available at:

http://127.0.0.1:5984/_utils/index.html

Port 5984 is only open to connections from localhost; if CouchDB is running on a virtual machine you may need to create a tunnel from the host to the virtual machine:

$ ssh ade -vNL 5984:localhost:5984