Apache CouchDB README
Travis CI master build status: |travisci|
.. |travisci| image:: https://travis-ci.org/apache/couchdb.svg?branch=master
Jenkins CI master build status: |jenkins|
.. |jenkins| image:: https://builds.apache.org/buildStatus/icon?job=CouchDB
For a high-level guide to Unix-like systems, inc. Mac OS X and Ubuntu, see:
For a high-level guide to Microsoft Windows, see:
Follow the proper instructions to get CouchDB installed on your system.
If you're having problems, skip to the next section.
We have documentation:
They include a changelog:
For troubleshooting or cryptic error messages, see:
For general help, see:
We also have an IRC channel:
The mailing lists provide a wealth of support and knowledge for you to tap into.
Feel free to drop by with your questions or discussion. See the official CouchDB
website for more information about our community resources.
Verifying your Installation
Run a basic test suite for CouchDB by browsing here:
Getting started with developing
For more detail, read the README-DEV.rst file in this directory.
Basically you just have to install the needed dependencies which are
documented in the install docs and then run
./configure && make.
You don't need to run
make install after compiling, just use
./dev/run to spin up three nodes. You can add haproxy as a caching
layer in front of this cluster by running
--haproxy=/path/to/haproxy . You will now have a local cluster
listening on port 5984.
For Fauxton developers fixing the admin-party does not work via the button in
Fauxton. To fix the admin party you have to run
./dev/run with the
./dev/run --admin=username:password. If you want to have an
admin-party, just omit the flag.
Cryptographic Software Notice
This distribution includes cryptographic software. The country in which you
currently reside may have restrictions on the import, possession, use, and/or
re-export to another country, of encryption software. BEFORE using any
encryption software, please check your country's laws, regulations and policies
concerning the import, possession, or use, and re-export of encryption software,
to see if this is permitted. See http://www.wassenaar.org/ for more
The U.S. Government Department of Commerce, Bureau of Industry and Security
(BIS), has classified this software as Export Commodity Control Number (ECCN)
5D002.C.1, which includes information security software using or performing
cryptographic functions with asymmetric algorithms. The form and manner of this
Apache Software Foundation distribution makes it eligible for export under the
License Exception ENC Technology Software Unrestricted (TSU) exception (see the
BIS Export Administration Regulations, Section 740.13) for both object code and
The following provides more details on the included cryptographic software:
CouchDB includes a HTTP client (ibrowse) with SSL functionality.