Skip to content
Mirror of Apache CouchDB
JavaScript Erlang Perl C CSS C++ Other
Find file
Pull request Compare This branch is 2 commits ahead, 2969 commits behind apache:master.
Failed to load latest commit information.
bin Fix for COUCHDB-1449 stopped status returned before couchdb process e…
build-aux Integrate Sphinx into autotools
etc Reduce PBKDF2 work factor
share COUCHDB-1783 support ASF comments system in
src COUCHDB-1696 really fix R14B04 support
test COUCHDB-1696 sort ETS table results in test suite to support R16B
utils Minor changes for new indexing engine.
var wheeeeeeee
.gitignore Merge branch 'fauxton'
.mailmap Integrate Sphinx into autotools
.travis.yml Include R15B03 and R16B in travis-ci build matrix
AUTHORS Move myself from THANKS to AUTHORS.
BUGS Add Sphinx-related build changes into READMEs
CHANGES COUCHDB-1696 final commit and update docs
DEVELOPERS COUCHDB-1704: Add RedHat distro build dependencies to docs
INSTALL.Unix COUCHDB-1696 final commit and update docs
INSTALL.Windows COUCHDB-1696 final commit and update docs
LICENSE Merge branch 'fauxton' Removed checks, to include in release procedure
NEWS COUCHDB-1696 final commit and update docs
NOTICE Merge branch 'fauxton'
README Reverting commit, see COUCHDB-1418 Move myself from THANKS to AUTHORS. Switch to proper SemVer for builds, add acinclude checks, and remove …
bootstrap Switch to proper SemVer for builds, add acinclude checks, and remove … COUCHDB-1696 final commit and update docs
license.skip Ensure fauxton files are licensed to pass make distcheck


Apache CouchDB README


For a low-level guide, see:


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.


For troubleshooting, see:

If you're getting a cryptic error message, 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.

Running the Testsuite

Run the testsuite for couch.js and jquery.couch.js by browsing here:

It should work in at least Firefox >= 3.6 with Private Browsing mode enabled.

Read more about JSpec here:

When you change the specs, but your changes have no effect, manually reload
the changed spec file in the browser. When the spec that tests Erlang views
fails, make sure you have enabled Erlang views as described here:

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 <> 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
source code.

The following provides more details on the included cryptographic software:

CouchDB includes a HTTP client (ibrowse) with SSL functionality.
Something went wrong with that request. Please try again.