A newer version of this documentation is available.

View Latest

Do a Quick Install

    First-time users can get Couchbase Server running simply and rapidly by using Docker. Once you install Docker, you can use a single command to download and install a pre-configured version of Couchbase Server Enterprise Edition on your computer.
    The Docker container image that is used in this topic is meant to set up a 'sandbox' version of Couchbase Server. It’s based on the Enterprise Edition and contains scripts that automatically configure several Couchbase components during installation. Although this particular image works great for a demo, it is not meant for production. For information about using containers to run Couchbase Server in production, see the Cloud and Container Deployment Overview.

    Download and Install Docker

    Docker is a freely available application that lets you install a fully-configured instance of Couchbase Server with a single command. To set up Docker on your computer, go to the Docker installation page and follow the instructions.

    Use Docker to Install Couchbase Server

    Once Docker is installed on your computer, you can go ahead and install Couchbase Server.

    You may need administrative or root privileges on your computer to complete the installation.

    Open a console window on your computer and enter the following command:

    docker run -t --name db -p 8091-8094:8091-8094 -p 11210:11210 couchbase/server-sandbox:6.6.0

    When you run the command, Docker downloads, installs, and configures Couchbase Server. Eventually, Couchbase Server is started in a Docker virtual environment:

    Starting Couchbase Server -- Web UI available at http://<ip>:8091
    and logs available in /opt/couchbase/var/lib/couchbase/logs
    Configuring Couchbase Server.  Please wait (~60 sec)...
    Configuration completed!
    Couchbase Admin UI: http://localhost:8091
    Login credentials: Administrator / password

    From this point onward, don’t close the console while you’re using Couchbase Server; this terminates both Docker and Couchbase Server.


    You can now proceed to the next step: Explore the Server Configuration.

    Other Destinations

    • Installing the Couchbase Server Cluster: Explains how to install Couchbase Server directly onto your host, without the use of Docker or any other virtual environment. This kind of direct install is very common for production-deployments, as well as development and testing activities.

    • Create a Cluster: Provides a detailed explanation of how to provision a Couchbase Server-node, and thereby create a one-node Couchbase cluster. This is the procedure you will certainly use in production; as well as for testing different configurations. The available options include use of the Couchbase Server Web Console, the Couchbase REST API, and the Couchbase Command Line Interface.

    • Couchbase Server Startup and Shutdown: Explains how to start and stop the server using the commands that are specific to your underlying platform.