Create a CockroachDB Serverless (beta) Cluster

This page walks you through the process of creating a cluster using CockroachDB Serverless (beta). Note that only CockroachDB Cloud Console Administrators can create clusters. If you are a Developer and need to create a cluster, contact your CockroachDB Cloud Administrator.

Note:

CockroachDB Serverless is currently in beta. For information about its limitations, see CockroachDB Serverless (beta) FAQs.

Before you begin

If you haven't already, sign up for a CockroachDB Cloud account.

Step 1. Start the cluster creation process

  1. Log in to your CockroachDB Cloud account.
  2. If there are multiple organizations in your account, select the correct organization in the top right corner.
  3. On the Overview page, click Create Cluster.

Step 2. Select a cloud provider & region

  1. (Optional) Select a cloud provider (GCP or AWS) in the Cloud provider section.

  2. (Optional) Select a region in the Regions section. For optimal performance, select the cloud provider region closest to the region in which you are running your application.

Step 3. Enter a spend limit

Every cluster starts with 10M RUs of free burst capacity each month and earns 100 RUs per second up to a maximum of 250M free RUs per month. Earned RUs can be used immediately or accumulated as burst capacity. If you use all of your burst capacity, your cluster will revert to baseline performance.

If you set a spend limit, your cluster will not be throttled to baseline performance once you use all of your free earned RUs. Instead, it will continue to use burst performance as needed until you reach your spend limit. You will only be charged for the resources you use up to your spend limit. If you reach your spend limit, your cluster will revert to the baseline performance of 100 RUs per second.

For more information on determining your resource usage, see Planning your cluster.

Note:

Regardless of whether you set a spend limit, adding billing information for your organization allows you to use cloud storage for bulk operations. Organizations without billing information are limited to using userfile storage for bulk operations.

  1. Click Create cluster.

Your cluster will be created in a few seconds.

  1. Enter your Spend limit.

    This is the maximum amount you could be charged per month. You will be charged only for what you use.

  2. Click Next: Payment info.

  3. Verify your cluster configuration and spend limit.

    Note:

    The cost displayed does not include taxes.

  4. Add your preferred payment method.

  5. Click Create cluster.

Your cluster will be created in a few seconds.

What's next

Usage examples

Free CockroachDB Serverless (beta) clusters can be used for proofs-of-concept, toy programs, or to use while completing Cockroach University.

For examples of applications that use free CockroachDB Cloud clusters, check out the following Hack the North projects:

YesYes NoNo