Awesome Open Source
Awesome Open Source

CouchDB Packaging support repo

The main purpose of this repository is to provide packaging support files for Apache CouchDB and its SpiderMoneky 1.8.5 dependency, for a number of well-known and used packaging formats, namely:

  • .deb files, as used by Debian, Ubuntu, and derivatives
  • .rpm files, as used by CentOS, RedHat, and derivatives
  • snapcraft files, as used by the Ubuntu Snappy package manager


On a system with all necessary build-time dependencies:

SpiderMonkey 1.8.5


make couch-js-rpms


make couch-js-debs PLATFORM=$(lsb_release -cs)


rpms or debs from master branch:

cd .. && git clone
cd couchdb-pkg && make build-couch $(lsb_release -cs) PLATFORM=$(lsb_release -cs)

rpms or debs from a release tarball:

make copy-couch $(lsb_release -cs) COUCHTARBALL=path/to/couchdb-#.#.#.tar.gz PLATFORM=$(lsb_release -cs)

Building inside the couchdbdev docker containers

You must first pull down the image or images you need from Docker Hub, or build the images using the apache/couchdb-ci repository. A full list of supported environments is at .

SpiderMonkey 1.8.5

docker pull couchdbdev/<os>-<codename>-base
./ js <os>-<codename>    # for example, debian-stretch, ubuntu-bionic or centos-7.


From a downloaded CouchDB tarball:

docker pull couchdbdev/<osname>-<codename>-erlang-<erlang-version>
ERLANGVERSION=<erlang-version> ./ couch <os>-<codename> path/to/couchdb-#.#.#.tar.gz

Directly from the Apache source CDN:

docker pull couchdbdev/<osname>-<codename>-erlang-<erlang-version>
./ couch <os>-<codename>

Building packages for a release


  1. Linux running Docker
  2. The current user must be capable of running docker run.
  3. Enough free disk space to download all of the Docker images + build CouchDB.

Running the package build

You can either build packages from a local CouchDB dist tarball (the output of make dist), or from a URL of a published CouchDB dist tarball (such as the ones on The package's version number will be derived from the filename of the CouchDB dist tarball.


$ ./ couch-all path/to/apache-couchdb-VERSION.tar.gz


$ ./ couch-all http://url/to/apache-couchdb-VERSION.tar.gz

Packages will be placed in the pkgs/couch subdirectory.

A similar js-all target exists, should the SpiderMonkey packages need to be regenerated.

Uploading the packages

If you have Apache credentials (set your BINARY_CREDS environment variable appropriately), after building all CouchDB packages above, and signing the rpms with the appropriate GPG key using the rpmsign --addsign <file.rpm> command, simply run:

./ couch-upload-all

Or, for the SpiderMonkey packages:

./ js-upload-all

Snap packages


Feedback, Issues, Contributing

General feedback is welcome at our user or developer mailing lists.

Apache CouchDB has a CONTRIBUTING file with details on how to get started with issue reporting or contributing to the upkeep of this project.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,058,025
C Plus Plus (238,342
Shell (170,925
Database (92,945
Http (30,144
Cloud (29,224
Apache (16,411
Erlang (9,062
Couchdb (3,060
Packaging (3,045
Big Data (2,670
Network Server (139
Network Client (84