This page guides you through the process of creating a CockroachDB Standard cluster using the Cloud Console. To use the Cloud API instead, refer to Create a New Cluster.
Only CockroachDB Cloud Org Administrators or users with Cluster Creator / Cluster Admin roles assigned at organization scope can create clusters. If you need to create a cluster and do not have one of the required roles, contact your CockroachDB Cloud Administrator.
To create and connect to a 30-day free CockroachDB Standard cluster and run your first query, refer to the Quickstart.
Step 1. Start the cluster creation process
If you haven't already, sign up for a CockroachDB Cloud account.
Note:We recommend that CockroachDB Cloud Console users log in with Single Sign-On (SSO), optionally with two-factor authentication (2FA) enabled for the SSO provider. This prevents potential attackers from using stolen credentials to access or tamper with your critical data.CockroachDB Cloud Basic SSO supports SSO with GitHub, Google, and Microsoft. Cloud Organization SSO provides additional configuration and flexibility, and includes support for OIDC or SAML protocols, autoprovisioning, and limiting the email domains that can use a given authentication method.
Visit your CockroachDB Cloud Console's account settings page and switch to SSO to improve the security of your cluster.
Log in to your CockroachDB Cloud account.
If there are multiple organizations in your account, select the correct organization in the top right corner.
On the Overview page, click Create Cluster.
On the Select a plan page, select the Standard plan.
Step 2. Select the cloud provider
On the Cloud & Regions page, in the Cloud provider section, select your deployment environment: Google Cloud or AWS. Creating a CockroachDB Standard cluster on Azure is not yet supported.
You do not need an account in the deployment environment you choose. The cluster is created on infrastructure managed by Cockroach Labs. If you intend to use your CockroachDB Standard cluster with data or services in a cloud tenant that you manage, you should select that cloud provider and the region closest to your existing cloud services to maximize performance.
Pricing depends on your cloud provider and region selections.
Pricing depends on your cloud provider and region selections. Refer to Pricing for details.
Step 3. Configure region(s)
In the Regions section, select at least one region. Refer to CockroachDB Cloud Regions for the regions where CockroachDB Standard clusters can be deployed.
For optimal performance, select the cloud provider region nearest to the region where you are running your application. For example, if your application is deployed in GCP's us-east1 region, create your cluster on GCP and select us-east1 for your CockroachDB Standard cluster.
A multi-region cluster can survive the loss of a single region. For multi-region clusters, CockroachDB will optimize access to data from the primary region. Refer to Planning your cluster for the configuration requirements and recommendations for CockroachDB Standard clusters.
You cannot remove regions once they have been added.
After creating a multi-region cluster deployed on AWS, you can optionally set up AWS PrivateLink (Limited Access) so that incoming connections to your cluster from applications or services running in your AWS account flow over private AWS network infrastructure rather than the public internet.
Private connectivity is not available for Serverless clusters on GCP.
Click Next: Capacity.
Step 4. Provision cluster capacity
Provisioned capacity refers to the processing resources (Request Units per sec) reserved for your workload. Each 500 RUs/sec equals approximately 1 vCPU. We recommend setting capacity at least 40% above expected peak workload to avoid performance issues. Refer to Planning your cluster for the configuration requirements and recommendations for CockroachDB Standard clusters.
You will be charged only for the storage you use. Storage starts at $0.75/GiB hour and the cost varies by region.
Click Next: Finalize.
Step 5. Enter billing details
- On the Finalize page, verify your selections for the cloud provider, region(s), and the capacity.
Verify the hourly estimated cost for the cluster. The cost displayed does not include taxes.
You will be billed monthly.
Add your preferred payment method.
If applicable, the 30-day trial code is pre-applied to your cluster.
Note:Make sure that you delete your trial cluster before the trial expires. Your credit card will be charged after the trial ends. You can check the validity of the code on the Billing page.
Step 7. Name the cluster
The cluster is automatically given a randomly-generated name. If desired, change the cluster's name. The cluster name must be 6-20 characters in length, and can include lowercase letters, numbers, and dashes (but no leading or trailing dashes). A cluster's name cannot be edited after it is created.
Click Create cluster. Your cluster will be created in a few seconds.
What's next
To start using your CockroachDB Cloud cluster, see the following pages:
- Connect to your cluster
- Authorize users
- Deploy a Python To-Do App with Flask, Kubernetes, and CockroachDB Cloud
If you created a multi-region cluster, it is important to carefully choose:
- The right survival goal for each database.
- The right table locality for each of your tables.
Not doing so can result in unexpected latency and resiliency. For more information, see the Multi-Region Capabilities Overview.
Was this helpful?
