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 the Serverless 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.

    Note:
    We recommend that CockroachDB Cloud Console users log in with Single Sign-On (SSO), with two-factor authentication (2FA) enabled for the SSO provider. This prevents potential attackers from using stolen credentials to accesss or tamper with your critical data.

    CockroachDB Cloud currently supports SSO with GitHub, Google, and Microsoft.

    Visit your CockroachDB Cloud Console's account settings page and switch to SSO to improve the security of your cluster.

  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.

The best way to estimate your resource usage is to enter a spend limit you're comfortable with and run your workload. You can see the RUs and storage your cluster has used in the Usage this month section of the Cluster Overview page. Once enough usage data is available, you can also see a graph of your monthly resource usage and recommended spend limit on the Edit cluster page. For more information, 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