Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Mirror of Apache CouchDB
JavaScript Python Ruby Erlang Shell
branch: master

Git ignore .pyc (compiled python) files

PR: #323
PR-URL: #323
Reviewed-By: Robert Kowalski <>
latest commit 0a6298f2dd
@jaydoane jaydoane authored robertkowalski committed
Failed to load latest commit information.
bin Merge branch '1843-feature-bigcouch'
build-aux distcheck: remove softlink in build-aux
dev add no-join option
rel Don't include eunit.ini into release
share/server Goodbye Futon, old friend <3
support Build main.js
test add test for _changes?feed=live
.gitignore Git ignore .pyc (compiled python) files
.mailmap Integrate Sphinx into autotools
.travis.yml speed up build by caching apt repos
BUGS Add Sphinx-related build changes into READMEs
COMMITTERS Adding myself as a committer Moving to
Dockerfile Improve and document Docker test cluster setup
INSTALL.Unix Revert "Fix documentation to add package libkjsapi4"
INSTALL.Windows Docs: minor typo on INSTALL document
LICENSE license and notice for css.escape.js
Makefile Restore ability to make a cluster in Admin Party state
NOTICE license and notice for css.escape.js
README.rst Remove reference to non-existant document 'INSTALL'
TODO High-level notes on remaining post-merge work
Vagrantfile Fixed line wrapping in Vagrantfile.
configure Consolidate .ini files
license.skip Remove leftovers from broken becnhmark
rebar.config.script Remove couch_dbupdates, obsoleted by global_changes
setup_eunit.template Don't include eunit.ini into release


Apache CouchDB README


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, 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:

Getting started with developing

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. There is a haproxy config file in ./rel. Just run: cd rel && haproxy -f haproxy.cfg. 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 admin flag, e.g. ./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 <> for more information.

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.