Create a Cluster

    Create a cluster so that you can store and access data in Couchbase Capella.


    Creating a cluster requires a connected cloud and a project. To create a cluster, you must have the Project Owner or Cluster Manager role

    Your organization must also have billing configured, otherwise you will be prompted to enter an Activation ID when attempting to create a cluster.


    1. To start creating a cluster, go to either the Dashboard or Clusters tab in the main navigation, and click Create Cluster.

      This opens the the Create Cluster fly-out menu.

    2. In the Cluster Name field, enter a name for the cluster.

      Note that this isn’t the cluster’s hostname, and can be changed at any time.

    3. Specify a cloud for the cluster to be deployed on.

      Use the toggle to switch between the available options for specifying a connected cloud for your cluster.

      Existing Cloud

      Use the Cloud drop-down menu to select an existing connected cloud.

      New Cloud

      Configure a new connected cloud to deploy your cluster on.

      For detailed information on configuring a new connected cloud, refer to Connect and Manage Clouds.

    4. Specify a project for the cluster to be deployed in.

      Use the toggle to switch between the available options for specifying a project for your cluster.

      Existing Project

      Use the Project drop-down menu to select an existing project.

      New Project

      Create a new project to deploy your cluster in.

    5. Once you’ve specified a name, cloud, and project for the cluster, click Create Cluster to continue.

      After completing this step, the cluster is saved within the project in a draft state. Draft clusters appear alongside all other clusters within the project, and you can return to them at any time. All continued changes to a draft cluster will be saved until it is deployed.

      If you need to abandon a draft cluster, you can delete it just as you would any other deployed cluster.

    6. Set the cluster size and configuration.

      The Cluster Sizing screen provides multiple different approaches to help you size and configure your cluster:

      Templates (Simple)

      Cluster templates provide pre-defined cluster configurations that are based on common workloads. Each template has a variety of different sizes, and selecting one will populate the entire cluster configuration for you.

      Read more about how to use templates.

      Custom Deployment Mode (Advanced)

      The Custom Deployment mode provides the most granular control over sizing and configuring your cluster. This option works well if you already have experience with Couchbase Server and/or want to re-create an existing Couchbase deployment using Couchbase Capella.

      Read more about how to use the Custom Deployment mode.

      Once you’ve configured the cluster to your liking, click Next.

      This brings you to the Deploy Cluster screen.

    7. Review the cluster configuration and select a Support Plan.

      The Deploy Cluster screen shows a summary of the configuration details. Review the configuration to ensure that it meets your expectations. You can click the Prev button at the bottom of the page to go back and make any necessary changes.

      Further down the page, in the Select Support Plan section, you must select a Support Time Zone and a Support Plan for the cluster.

      1. Use the Select Support Time Zone drop-down menu to select the Support Time Zone that is most appropriate for the cluster (such as when cluster administrators are able to interact with Couchbase Support staff).

      2. Select one of the available Support Plans.

        If you are using a Trial Activation ID, only the Free Trial Support Plan is available.

    8. Once you’re satisfied with the cluster configuration, click Deploy.

      Capella will proceed with automatically deploying the cluster on your connected cloud.

      Once the deployment begins, Capella will provision and maintain cluster resources in your cloud account. These resources will incur infrastructure cost in your cloud account for the lifecycle of the cluster.

      A cluster will generally take up to 15 minutes to deploy, though it can take longer depending on certain factors such as cluster size and cloud provider performance.

      Leaving the page will not affect deployment progress, and you can feel free to return to the cluster page at any time. You’ll receive a notification when the deployment is done.

    When you return to the cluster after it has been successfully deployed, you will be taken to the cluster’s Connect tab.