Installing on Mac OS X

Instructions for installing Couchbase Server on Mac OS X.
The Mac OS X platform is supported for development purposes only.

When installing Mac OSX nodes, only 64 bit systems are supported.
Before you install, verify the list of supported platforms.

The Mac OS X installation uses a zip file with a stand-alone application that must be copied to the Applications folder.
The installation location is not the same as the location of the Couchbase data files.

Use Archive Utility, the default archive file handler in Mac OS X, to unpack the Couchbase Server distribution.
It is more difficult to diagnose non-functioning or damaged installations after extraction by other third party archive extraction tools.

Installing with UI or CLI

To install Couchbase Server on Mac OSX use the GUI or the command line interface.

Locate the downloaded Couchbase Server .zip file, which typically is located in the default /Downloads folder.

Double-click the downloaded .zip installation file to extract the server.
This creates a single folder, the Couchbase Server.app application.

Drag-and-drop Couchbase Server.app to the system /Applications folder.

After the installation completes, double-click on Couchbase Server.app to start Couchbase Server.
The Couchbase Server icon appears in the menu bar on the right-hand side.
If the server was not configured, the setup process can be completed from the Couchbase Web Console.

Couchbase Server runs as a background application.
Click on the icon in the menu bar for list of operations that can be performed.

The command line interface (CLI) tools are included in the Couchbase Server application directory.
Access the CLI from a terminal window and use the full path of the Couchbase Server installation.
This is /Applications/Couchbase Server.app/Contents/Resources/couchbase-core/bin/ by default.