Couchbase Server on Mac OS X is for development purposes only.
The Mac OS X installation uses a Zip file which contains a
standalone application that can be copied to the
Applications folder or to any other
location you choose. The installation location is not the same
as the location of the Couchbase data files.
Due to limitations within the Mac OS X operating system, the Mac OS X implementation is incompatible with other operating systems. It is not possible either to mix operating systems within the same cluster, or configure XDCR between a Mac OS X and Windows or Linux cluster.
If you need to move data between a Mac OS X cluster and a cluster hosted on another platform, please use cbbackup and cbrestore. For more information, see Section 5.6.3, “Backup and Restore Between Mac OS X and Other Platforms”.
Delete any previous installs of Couchbase Server at the command line or by dragging the icon to the Trash can.
Remove remaining files from previous installations:
> rm -rf ~/Library/Application Support/Couchbase >rm -rf ~/Library/Application Support/Membase
Download the Mac OS X Zip file.
Double-click the downloaded Zip installation file to extract
the server. This will create a single folder, the
Couchbase Server.app application.
Drag and Drop
Couchbase Server.app to
your chosen installation folder, such as the system
Once the install completes, you can double-click on
Couchbase Server.app to start it. The
Couchbase Server icon appears in the menu bar on the right-hand
side. If you have not yet configured your server, then the
Couchbase Web Console opens and you should to complete the
Couchbase Server setup process. See
Section 2.3, “Initial Server Setup” for more
The Couchbase application runs as a background application. If you click on the icon in the menu bar you see a list of operations that can be performed, as shown in Figure 3.1, “Couchbase Server on Mac OS X — Menubar Item”.
The command line tools are included in the Couchbase Server
application directory. You can access them in Terminal by using
the full path of the Couchbase Server installation. By default,