Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Launch multiple CouchDBs from the same installation.
JavaScript Shell
branch: master

chore(travis): add slack hook

* * *

This commit was sponsored by The Hoodie Firm.
You can hire The Hoodie Firm:
latest commit 9c4c4ab2a8
@boennemann boennemann authored


Build Status Dependency Status devDependency Status

Launch multiple CouchDBs from the same installation, programmaticly or from the command line.


You can have many reasons for running more than one instance of the same CouchDB installation. Maybe you are developing multiple apps, and would like an instance per app, or you are just plain daring.

CouchDB allows you to run multiple separate instances from the same installation. So in addition to the default installation you can launch more.

To do that, you will need to adjust a few configuration variables. Namly:

  • The TCP port to bind to.
  • The database directory.
  • The view directory.
  • The log file.
  • The URI file.


To do this, we create a new CouchDB config file that includes all the values and start CouchDB with the default config files and this special one as well.


From Node:

var MultiCouch = require("multicouch");
var my_couch = new MultiCouch({
  port: 8080,
  prefix: "/tmp"
  // view_dir: "/tmp", // same as db_dir when ommitted
  // log_file: "/tmp/couch.log",
  // uri_file: "/tmp/couch.uri",
  // couchdb_path: "/opt/local/bin/couchdb"



my_couch.on("start", function() {
  console.log("CouchDB started.");

my_couch.on("stop", function() {
  console.log("CouchDB stopped.");

my_couch.on("error", function(error) {
  console.log("CouchDB errored '%s'.", error);

From the CLI:



Set the environment variable COUCHDB_PATH to the CouchDB binary you want to use.


Apache License 2.0


(c) 2013 Jan Lehnardt

Something went wrong with that request. Please try again.