couchdb

by apache

apache / couchdb

Seamless multi-master syncing database with an intuitive HTTP/JSON API, designed for reliability

4.7K Stars 929 Forks Last release: Not found Apache License 2.0 12.9K Commits 74 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Apache CouchDB README

+-----+ | |1| | +-----+

.. |1| image:: https://ci-couchdb.apache.org/job/jenkins-cm1/job/FullPlatformMatrix/job/main/badge/icon?subject=main%20build :target: https://ci-couchdb.apache.org/blue/organizations/jenkins/jenkins-cm1%2FFullPlatformMatrix/activity?branch=main

Installation

For a high-level guide to Unix-like systems, inc. Mac OS X and Ubuntu, see:

INSTALL.Unix

For a high-level guide to Microsoft Windows, see:

INSTALL.Windows

Follow the proper instructions to get CouchDB installed on your system.

If you're having problems, skip to the next section.

Documentation

We have documentation:

http://docs.couchdb.org/

It includes a changelog:

http://docs.couchdb.org/en/latest/whatsnew/

For troubleshooting or cryptic error messages, see:

http://docs.couchdb.org/en/latest/install/troubleshooting.html

For general help, see:

 http://couchdb.apache.org/#mailing-list

We also have an IRC channel:

http://webchat.freenode.net/?channels=couchdb

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:

http://127.0.0.1:5984/_utils/#verifyinstall

Getting started with developing

For more detail, read the README-DEV.rst_ file in this directory.

.. _README-DEV.rst: https://github.com/apache/couchdb/blob/master/README-DEV.rst

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
./dev/run --with-haproxy
--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. If you run

./dev/run
, an admin user
root
with a random password is generated (see the output of the script). If you want to set an admin user, start with the admin flag, e.g.
./dev/run --admin=username:password
. If you want to have an admin-party, run
./dev/run --with-admin-party-please
. To see all available options, please check
./dev/run --help
.

Contributing to CouchDB

You can learn more about our contributing process here:

https://github.com/apache/couchdb/blob/master/CONTRIBUTING.md

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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.