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
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.
For information on installing Couchbase Server on IPv6 systems, see IP Version 6: Set-Up Procedures.
Delete any previous installations of Couchbase Server using the command line or by dragging the icon to the Trash can.
Remove remaining files from previous installations using these commands:
rm -rf ~/Library/Application\ Support/Couchbase rm -rf ~/Library/Application\ Support/Membase
To install Couchbase Server on Mac OSX use the GUI or the command line interface.
Locate the downloaded Couchbase Server
.zipfile, which typically is located in the default /Downloads folder.
Double-click the downloaded
.zipinstallation file to extract the server. This creates a single folder, the
Couchbase Server.appto 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.
The initial sample Couchbase Server administrator user credentials are as follows:
Change the user name and password to your preferred values immediately after the initial login to the Couchbase Web Console.
When installing Mac OSX nodes, only 64 bit systems are supported.
If you perform a non-sudo, non-root installation, you can run Couchbase Server and all its command-line tools.
To install as non-root, non-sudo:
After downloading Couchbase Server, open terminal and go to the Downloads directory:
Unzip the package containing Couchbase Server:
Move Couchbase Server application to your /Applications folder:
mv couchbase-server-version/Couchbase\ Server.app /Applications/
Start Couchbase Server from the terminal:
open /Applications/Couchbase\ Server.app
This enables you to use Couchbase Server as a non-sudo, non-root user.
To stop the Couchbase Server, click on its icon in the menu bar and select Quit Couchbase Server.