Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Development branches
Erlang JavaScript Perl C C++ Ruby Other
Latest commit b0420f9 @vmx vmx Fix CORS error with attachments
When attachments were returned (?attachments=true) while CORS was
enabled and used, an error occured. The reason for this error
were headers that were encoded as binaries instead of lists. String
operations on binaries throw errors.

This commit fixes COUCHDB-1689.
Failed to load latest commit information.
bin Automatically support CouchDB plugins (GeoCouch, BrowserID, OAuth, etc.)
build-aux Integrate Sphinx into autotools
etc COUCHDB-1667: Revert index_dir to view_index_dir config option.
share Update copyright year to 2013
src Fix CORS error with attachments
test Fix CORS error with attachments
utils Minor changes for new indexing engine.
var wheeeeeeee
.gitignore Integrate Sphinx into autotools
.mailmap Integrate Sphinx into autotools
.travis.yml Integrate Sphinx into autotools
AUTHORS Move myself from THANKS to AUTHORS.
BUGS Add Sphinx-related build changes into READMEs
CHANGES fix up 1.1.1 section
DEVELOPERS Added info about release time deps
INSTALL.Unix Update ICU url
INSTALL.Windows Update ICU url
LICENSE update erlang-oauth to 1.3.0 Removed checks, to include in release procedure
NEWS Added CVE-2010-2234 to NEWS and CHANGES
NOTICE Update copyright year to 2013
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 … Integrate Sphinx into autotools
license.skip fix `make dist`


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.