apache / couchdb

Apache CouchDB README
=====================
+---------+
| |1| |2| |
+---------+
.. |1| image:: https://ci-couchdb.apache.org/buildStatus/icon?job=FullPlatformMatrix%2Fmain&subject=main
 :target: https://ci-couchdb.apache.org/job/FullPlatformMatrix/job/main
.. |2| image:: https://readthedocs.org/projects/couchdb/badge/?version=latest
 :target: https://docs.couchdb.org/en/latest/?badge=latest
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:
 https://docs.couchdb.org/
It includes a changelog:
 https://docs.couchdb.org/en/latest/whatsnew/
For troubleshooting or cryptic error messages, see:
 https://docs.couchdb.org/en/latest/install/troubleshooting.html
For general help, see:
 https://couchdb.apache.org/#mailing-list
We also have an IRC channel:
 https://web.libera.chat/#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
-------------------------------
**Quickstart:**
.. image:: https://img.shields.io/static/v1?label=Remote%20-%20Containers&message=Open&color=blue&logo=visualstudiocode
 :target: https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/apache/couchdb
If you already have VS Code and Docker installed, you can click the badge above or
`here `_
to get started. Clicking these links will cause VS Code to automatically install the
Remote - Containers extension if needed, clone the source code into a container volume,
and spin up a dev container for use.
This ``devcontainer`` will automatically run ``./configure && make`` the first time it is created.
While this may take some extra time to spin up, this tradeoff means you will be able to
run things like ``./dev/run``, ``./dev/run --admin=admin:admin``, ``./dev/run --with-admin-party-please``,
and ``make check`` straight away. Subsequent startups should be quick.
**Manual Dev Setup:**
For more detail, read the README-DEV.rst file in this directory.
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