A newer version of this documentation is available.

View Latest

Installing on Windows

Installation using a package management system on Windows.

This installation guide only supports both 32 and 64-bit systems. Windows 7 and 8 are supported only for development purposes. See Supported platforms for details.

Prerequisites

To install Couchbase Server on Windows, you need to perform following prerequisites:

  1. Make sure that you have no anti-virus software running on the machine before you start the installation process.

  2. Verify that you have administrator privileges using a local system account on the machine where you are performing the installation.

  3. By default, on Windows the TCP/IP has default number of ports available for client communication.

    You need to follow the information provided in Avoiding TCP/IP Port Exhaustion to adjust the configuration and increase the number of available ports.

  4. By default, the Windows system does not provide an adequate number of ephemeral ports for Couchbase Server clusters. Without the correct number of open ephemeral ports, you can experience errors during rebalance, timeouts on clients, and failed backups.

    The Couchbase Server installer will automatically check for your current port setting and adjust it if needed. See Microsoft KB-196271.

Couchbase Server uses the Microsoft C++ redistributable package, which is automatically downloaded during installation. However, if another application on your machine is already using the package, your installation process can fail. To make sure that your installation process completes successfully, shut down all other running applications during installation. For Windows 2008, you must upgrade your Windows Server 2008 R2 installation with Service Pack 1 installed before running Couchbase Server. You can obtain Service Pack 1 from Microsoft TechNet.

Downloading on Windows systems

You can download Couchbase Server directly using the wget.exe command for Windows or Powershell scripting.

The basic syntax of the wget command is:

$ wget [option]... [url]...

For example, the following command downloads a version of Couchbase Server and that runs on Windows Server 2012 R2:

$ wget.exe --no-check-certificate http://packages.couchbase.com/releases/version/couchbase-server-enterprise-version-windows_amd64.exe