Table of Contents

CouchDBX

The easiest way to get started with CouchDB on Mac OS X is by downloading CouchDBX from http://janl.github.com/couchdbx/. This unofficial application doesn’t install anything to your system and can be run with a single double-click. Note, however, that for more serious use, it is recommended that you do a traditional installation with something like MacPorts.

MacPorts

MacPorts is the de facto package management tool for Mac OS X. While not and official part of the operating system, it can be used to simplify the process of installing FLOSS software on your machine. Before you can install CouchDB with MacPorts, you need to download and install MacPorts from http://www.macports.org/install.php.

Make sure you MacPorts installation is up-to-date by running:

sudo port selfupdate

You can install CouchDB with MacPorts by running:

sudo port install couchdb

This command will install all of the necessary dependencies for CouchDB. If a dependency was already installed, MacPorts will not take care of upgrading the dependency to the newest version. To make sure that all of the dependencies are up to date, you should also run:

sudo port upgrade couchdb

Mac OS X has a service management framework called launchd that can be used to start, stop, or manage system daemons. You can use this to start CouchDB automatically when the system boots up. If you want to add CouchDB to your launchd configuration, you should run:

sudo launchctl load -w /opt/local/Library/LaunchDaemons/org.apache.couchdb.plist

After running this command, CouchDB should be available at:

CouchDB will also be started and stopped along with the operating system.