A newer version of this documentation is available.

View Latest

Ubuntu/Debian Installation

This installation information applies both to Ubuntu and Debian platforms.

Only 64 bit systems are supported.

You need to be logged in as root (superuser) to complete the installation.

  1. For Ubuntu version 12.04 and Debian 7, you need OpenSSL 1.x. Install a specific OpenSSL dependency by running:

    root-> apt-get install libssl version

  2. To install, use the dpkg command-line tool using the DEB file that you downloaded. The following example uses dpkg for installation:

    dpkg -i couchbase-server version.deb

    where version is the version number of the downloaded package.

    After the dpkg command is executed, Couchbase Server starts automatically and is configured to automatically start during boot under the 2, 3, 4, and 5 run levels. Refer to the Ubuntu documentation for more information about installing packages using the Debian package manager.

    After installation is completed, the installation process displays a message similar to the following:

    Selecting previously deselected package couchbase-server.
    (Reading database … 73755 files and directories currently installed.)
    Unpacking couchbase-server (from couchbase-server_x86_64_2.1.0-xxx-rel.deb) …
    libssl0.9.8 is installed. Continue installing
    Minimum RAM required : 4 GB
    System RAM configured : 4058708 kilobytes
    Minimum number of processors required : 4 cores
    Number of processors on the system : 4 cores
    Setting up couchbase-server  …
    Starting couchbase-server[  OK  ]
    You have successfully installed Couchbase Server.
    Browse to http://cen-1733:8091/ to configure your server.
    Refer to http://couchbase.com for additional resources.
    Update your firewall configuration to
    allow connections to the following ports: 11211, 11210, 11209, 4369,
    8091, 8092, 18091, 18092, 11214, 11215 and from 21100 to 21299.
    By using this software you agree to the End User License Agreement.
    See /opt/couchbase/LICENSE.txt.
After successful installation, use the service command to manage the Couchbase Server service, including checking the current status. Refer to the Ubuntu documentation for instructions.

Microsoft Azure Ubuntu version 12 and Ubuntu version 14 images from Canonical may throw the following warning messages during installation. The installation completes without a problem and it is safe to ignore these messages.

sent invalidate(group) request, exiting

sent invalidate(passwd) request, exiting

Open a web browser and access the Couchbase Web Console to set up Couchbase Server.

Installing as non-root, non-sudo

Installation on Ubuntu as non-root, non-sudo user is used only for development purposes.

This installation method is intended only for development purposes and is not supported in production.

Only 64 bit systems are supported.

A non-root, non-sudo installation will run Couchbase Server and all Couchbase Server command-line tools.

  1. After downloading the Couchbase Server DEB package, go to the directory where it is located and extract it:

    dpkg-deb -x couchbase-server-version.deb $HOME

    In the directory where you extracted the files, you will see /opt and /etc subdirectories.

  2. After you extract the Couchbase Server installation files, go to the subdirectory:

    cd opt/couchbase
  3. Run the following script to relocate the Couchbase Server installation to the present working directory (PWD):

    ./bin/install/reloc.sh `pwd`

    This allows you to continue the installation as a non-root, non-sudo user.

  4. To run the server use

    ./bin/couchbase-server -- -noinput -detached
  5. To stop the server use

    ./bin/couchbase-server -k

Installing using apt-get

This installation uses a package management system.

To install on Ubuntu 12.04 or 14.04, and Debian 7 or 8, using apt-get:

  1. Download and install the appropriate meta package from the package download location. This will install the package source and the Couchbase public keys:

    curl -O http://packages.couchbase.com/releases/couchbase-release/couchbase-release-1.0-3-amd64.deb
    sudo dpkg -i couchbase-release-1.0-3-amd64.deb
  2. Proceed with installing the actual Couchbase Server package:

    sudo apt-get update


    sudo apt-get install couchbase-server


    sudo apt-get install couchbase-server-community