frodenas/couchdb repository overview

⁠CouchDB Dockerfile

A Dockerfile that produces a Docker Image for Apache CouchDB⁠.

⁠CouchDB version

The master branch currently hosts CouchDB 1.6.

Different versions of CouchDB are located at the github repo branches⁠.

⁠Usage

⁠Build the image

To create the image frodenas/couchdb, execute the following command on the docker-couchdb folder:

$ docker build -t frodenas/couchdb .

⁠Run the image

To run the image and bind to host port 5984:

$ docker run -d --name couchdb -p 5984:5984 frodenas/couchdb

The first time you run your container, a new user couchdb with all privileges will be created with a random password. To get the password, check the logs of the container by running:

docker logs <CONTAINER_ID>

You will see an output like the following:

========================================================================
CouchDB User: "couchdb"
CouchDB Password: "jPp5fBJySeuJPTN8
========================================================================

⁠Credentials

If you want to preset credentials instead of a random generated ones, you can set the following environment variables:

• COUCHDB_USERNAME to set a specific username
• COUCHDB_PASSWORD to set a specific password

On this example we will preset our custom username and password:

$ docker run -d \
    --name couchdb \
    -p 5984:5984 \
    -e COUCHDB_USERNAME=myusername \
    -e COUCHDB_PASSWORD=mypassword \
    frodenas/couchdb

⁠Databases

If you want to create a database at container's boot time, you can set the following environment variables:

• COUCHDB_DBNAME to create a database

On this example we will preset our custom username and password and we will create a database:

$ docker run -d \
    --name couchdb \
    -p 5984:5984 \
    -e COUCHDB_USERNAME=myusername \
    -e COUCHDB_PASSWORD=mypassword \
    -e COUCHDB_DBNAME=mydb \
    frodenas/couchdb

⁠Persistent data

The CouchDB server is configured to store data in the /data directory inside the container. You can map the container's /data volume to a volume on the host so the data becomes independent of the running container:

$ mkdir -p /tmp/couchdb
$ docker run -d \
    --name couchdb \
    -p 5984:5984 \
    -v /tmp/couchdb:/data \
    frodenas/couchdb

⁠Copyright

Copyright (c) 2014 Ferran Rodenas. See LICENSE⁠ for details.