A newer version of this documentation is available.

View Latest

Install or provision the Couchbase server

    February 16, 2025
    + 12
    A short tutorial that will guide the developer in downloading and installing Couchbase, then creating a database to store our student records.

    Installation

    Couchbase can be installed as either:

    • A standalone application

    • A Docker instance

    If you’re familiar with Docker, then it’s recommended that you use Docker to install the server. Otherwise, go with the standalone installation.

    Using any browser, navigate to https://www.couchbase.com/downloads to download the server installation pack.

    Pick the Couchbase server option for your free trial.

    Couchbase download page
    You may need to fill out a brief web form before you can download the installation package.

    Select Couchbase Server, and from there, download the community edition of the server.

    Download Couchbase community edition dialog
    Make sure you download the latest version of the server software.

    Once you’ve downloaded the software, install it on your machine. (The method for installation will depend on your operating system).

    The method for running the application will, again, depend on your host operating system. In our example, we’re using a Mac, so the installation will place then executable app in the standard Applications folder.

    Set up a new cluster

    Each Couchbase server can run as its own cluster, or join another cluster to form a multi-node system. For the purposes of this basic tutorial, we’re only going to concern ourselves with running as a single node.

    You can always find the server’s configuration page by pointing your browser at: http://127.0.0.1:8091.
    Click button to set up new cluster

    Press Setup New Cluster to create your new cluster. The next page will allow you to fill in details for the cluster:

    Enter the cluster details

    Since we’re going to be housing student records, let’s call the cluster student-cluster. You’ll also need an admin username and a strong yet memorable password. Since this is just a demonstration, leave the administrator username as Administrator. After you’ve filled in the details, press Next: Accept Terms.

    Since this is a tutorial, then feel free to use something like password for your password. In a real system, of course, you’ll use something much stronger.

    On the next page, you’ll find the terms and conditions for using Couchbase. If you’re happy with them, then check the box and press Finish with Defaults.

    You’re now on the main dashboard page.

    Next steps

    Now you have installed the server and created a cluster, the next thing to do is create the database where you’re going to store your documents. In Buckets, Scopes and Collections you will also learn other ways in which Couchbase allows you to logically partition your data.