You need to be added to the ContributorsGroup to edit the wiki. But don't worry! Just email any Mailing List or grab us on IRC and let us know your user name.
Contents
The CouchDB project includes GNU autotools based scripts to build from source, which creates a self-extracting install package for Windows. The official release artefact is the signed tar.gz archive, and additionally, a signed binary is available also on the Apache Mirrors for convenience.
Instructions on building from source are available, as well as annotations for older releases.
Supported / Tested Platforms
This installer has been tested on 64 and 32 bit versions of:
- Windows Server 2008 both RTM and R2
- Windows 7 and Vista
- Windows Server 2003 and Windows XP
It is likely to work on most Windows versions released this century.
Dependencies
None - the installer includes erlang, openssl, ICU, spidermonkey and everything else you need including Microsoft Visual C++ runtimes.
Current Versions
couchdb-master - snapshot builds rolled from "trunk" or "master" in git terms - noteworthy snapshots and bleeding edge.
Use Firefox to run the CouchDB tests from Futon, to verify that your installation is successful, by pointing your web browser to http://127.0.0.1:5984/_utils/index.html and run the test suite.
If you encounter any troubles, in local.ini, set the [log] level=debug and begin investigating. Bug reports and patches are welcomed!
Older Versions
Previously contributed versions for Windows are available at:
Known Issues relating to Windows build
CouchDB 1.2.0
- none known
CouchDB 1.1.1
- none known
CouchDB 1.0.3
CouchDB 1.0.2
Currently there are a number of non-critical issues in 1.0.2 that you need to be aware of; both have work-arounds documented in the JIRA comments. These are both resolved in CouchDB 1.1.1 and newer.
COUCHDB-577 couchdb @ winxp: Simple RegExp's can not be executed
COUCHDB-963 while running CouchDB as a service, the erlang erlsrv process dies periodically during restarting CouchDB (POST /_restart fails) - either use the .bat version only, or apply the workarounds noted within the ticket comments. This is addressed upstream in Erlang/OTP R14B03 and a work-around in CouchDB 1.0.3 & later.
Download couchdb-1.0.2 - With Erlang/OTP R14B01 and JS 1.8.0 here
CouchDB 1.0.1
Note that CouchDB versions prior to 1.0.2 should not be used due to:
1 cross-site scripting security issue CVE-2010-3854
2 bugs that, in certain situations, could cause data loss COUCHDB-852 and COUCHDB-844.
Only on Windows, CouchDB 1.0.1 crashes on Windows when a database or index file reaches 4Gb in Erlang/OTP versions previous to R14B01. This is due to a Erlang/OTP Windows bug related with appending to files with a size equal to 4Gb or larger. Erlang/OTP release R14B01 no longer has this bug.
A significant stability bug was resolved in Erlang/OTP R13B04 which caused CouchDB to hang occasionally when run as a service.