2.3. Installation on Mac OS X

2.3.1. Installation using the Apache CouchDB native application

The easiest way to run CouchDB on Mac OS X is through the native Mac OS X application. Just follow the below instructions:

  1. Download Apache CouchDB for Mac OS X. Old releases are available at archive.
  2. Double click on the Zip file
  3. Drag and drop the Apache CouchDB.app into Applications folder

That’s all, now CouchDB is installed on your Mac:

  1. Run Apache CouchDB application
  2. Open up Fauxton, the CouchDB admin interface
  3. Verify the install by clicking on Verify, then Verify Installation.
  4. Time to Relax!

2.3.2. Installation with Homebrew

The Homebrew build of CouchDB 2.0 is still in development. Check back often for updates.

Running as a Daemon

CouchDB no longer ships with any daemonization scripts.

You can use the launchctl command to control the CouchDB daemon.

The couchdb team recommends runit to run CouchDB persistently and reliably. Configuration of runit is straightforward; if you have questions, reach out to the CouchDB user mailing list.

Naturally, you can configure launchd or other init daemons to launch CouchDB and keep it running using standard configuration files.

Consult your system documentation for more information.

Table Of Contents

Previous topic

2.2. Installation on Windows

Next topic

2.4. Installation on FreeBSD

More Help