Installing and Operating Couchbase Server Community Edition (CE)


    This tutorial will walk you through the steps to launch a single node server and manage some basic aspects.

    This tutorial was built using the Community Edition(CE) of Couchbase Server, so you can use this distribution to follow this guide free of charge.

    Introduction to Couchbase Server Community Edition

    Couchbase Server is an integrated document database and key-value store with a distributed architecture for performance, scalability, and availability. It enables developers to build applications easier and faster by leveraging the power of SQL with the flexibility of JSON.

    For additional questions and feedback, please check tagged questions on Stack Overflow or the Couchbase Forums.


    Tested for Ubuntu 18.04, macOS Mojave and Windows 10.

    You can install the server in your machine (bare metal) or use a containerization tool such as Docker, to speed up this part of the tutorial.


    This would be the fastest and easiest way to get the server started. If you need help installing Docker, their official documentation contains installation guides for multiple operating systems.

    After Docker is up and running you can type this command on your terminal to launch the server.

    docker run -itd --name couchbase-server -p 8091-8094:8091-8094 -p 11210:11210 couchbase:community

    For a more extensive install guide, you can check the Couchbase image description on Dockerhub.

    Bare Metal

    • Ubuntu 18.04

    • Windows 10

    • macOS

    First, open your terminal and install these tools, used by some of the core Couchbase Server packages.

    sudo apt update
    sudo apt install curl lsb-release gnupg

    Download and install the .deb meta-package, it contains the necessary information for apt to retrieve Couchbase’s necessary packages and public signing keys.

    curl -O
    sudo dpkg -i ./couchbase-server-community_6.5.0-ubuntu18.04_amd64.deb

    Now you are ready to install the Couchbase Server CE latest release.

    sudo apt update
    sudo apt install couchbase-server-community

    For a more extensive install guide, you can follow the Couchbase documentation for Ubuntu 18.04.

    Download the MSI installer from this link.

    Execute it and follow the wizard.

    install windows

    For a more extensive install guide, you can follow the Couchbase documentation for Windows 10.

    Download the zip file from this link and open it, it will be send to Downloads folder.

    mac unzip

    Open the folder and drag the application to you Applications folder.

    mac open

    Double click the Couchbase Server application to start the server.

    mac installed

    You can now use the navigation tab icon on the top right corner of your desktop to manage your server.

    mac bar mac bar open

    For a more extensive install guide, you can follow the Couchbase documentation for macOS.


    The server starts automatically after installation but you can manage this behavior, as shown here.

    If everything went well during installation, when you open up your browser on http://localhost:8091 you should see the Couchbase Server Web Console.

    couchbase front

    The next step will be to configure your server, so click on Setup New Cluster.

    Choose a server name and an administrator with a password, these credentials must be saved for later use.

    Now press Finish With Defaults, this should be enough to follow our tutorial. If you wish to better configure the server, up to your particular needs, follow this link.

    init server

    You now have a functional Couchbase Server CE.

    Next Steps

    We recommend you to follow our next tutorials, go to the Getting Started with Couchbase Community Edition page to find the full list.

    Also, you could review Couchbase Documentation to learn more about all sorts of topics.