2.5. Installation via Docker

Apache CouchDB provides ‘convenience binary’ Docker images through Docker Hub at apache/couchdb. The following tags are available:

  • latest, 2.1.0: CouchDB 2.1, single node
  • 1, 1.6, 1.6.1: CouchDB 1.6.1
  • 1-couchperuser, 1.6-couchperuser, 1.6.1-couchperuser: CouchDB 1.6.1 with couchperuser plugin
  • 2.0.0: CouchDB 2.0, single node

These images are built using Debian 8 (jessie), expose CouchDB on port 5984 of the container, run everything as user couchdb, and support use of a Docker volume for data at /opt/couchdb/data.

Note that you can also use the NODENAME environment variable to set the name of the CouchDB node inside the container.

Be sure to complete the First-time Setup steps for a single node or clustered installation.

Further details on the Docker configuration are available in our couchdb-docker git repository.