1.5. Installation via Docker

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

  • latest, 3, 3.0, 3.0.0: CouchDB 3.0.0, single node
  • 2, 2.3, 2.3.1: CouchDB 2.3.1, single node
  • 1, 1.7, 1.7.2: CouchDB 1.7.2
  • 1-couchperuser, 1.7-couchperuser, 1.7.2-couchperuser: CouchDB 1.7.2 with couchperuser plugin

These images are built using Debian 9 (stretch), 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.

Your installation is not complete. Be sure to complete the Setup steps for a single node or clustered installation.

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