Chapter 2. Installation

Couchbase Server is designed to be very easy to install, and both the initial installation and the addition of new nodes into the cluster is a straightforward process. Once the core software has been installed, you need to perform a setup process that configures your new node.

It should take no more than five minutes to get Couchbase Server up and running and in a state where you can start storing and retreiving data. There’s no need to go into complex deployment or configuration stages before installing. Couchbase is designed to be expandable by simply adding more nodes to your existing cluster.

In this chapter, we’ll work through the basics of building your first cluster and installing and setting up each node.


Couchbase Server can be installed on Windows, Linux, and Mac OS X (developer only). You cannot mix platforms within the same cluster. Your cluster must be entirely Linux- or Windows-based, ideally using servers with an identical hardware configuration.

With that in mind, at the time of writing, the following are the main operating systems supported:

  • RedHat Enterprise Linux 5.4 (32-bit and 64-bit)

  • Ubuntu Linux 10.04 (32-bit and 64-bit)

  • Windows Server 2008 (32-bit and 64-bit)

For the hardware configuration, an absolute minimum of a dual-core CPU is required. You can test Couchbase Server on machines with 1GB RAM or more, ideally 4GB RAM. Using this configuration for development and testing (but not performance testing) is fine. For full-scale deployment, ...

Get Getting Started with Couchbase Server now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.