# [CouchDB](http://couchdb.org)

## 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