This page guides you through the process of creating a cluster using CockroachDB Basic. Note that only CockroachDB Cloud Org Administrators or users with Cluster Creator / Cluster Admin roles assigned at organization scope can create clusters. If you are a Developer and need to create a cluster, contact your CockroachDB Cloud Administrator.
New CockroachDB Basic clusters always use the latest stable version of CockroachDB, and are automatically upgraded to new patch versions, as well as new major versions, to maintain uninterrupted support and SLA guarantees. For more details, refer to CockroachDB Cloud Upgrade Policy.
Before you begin
If you haven't already, sign up for a CockroachDB Cloud account.
Organizations without billing information on file can only create one CockroachDB Basic cluster.
Step 1. Start the cluster creation process
If you haven't already, sign up for a CockroachDB Cloud account, then log in.
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.
If there are multiple organizations in your account, verify the one that is selected in the top right corner.
On the Clusters page, click Create Cluster or, if you also have permission to create folders, then click Create > Create Cluster.
On the Select a plan page, select Basic.
Step 2. Select the cloud provider
On the Cloud & Regions page, select a cloud provider (GCP or AWS) in the Cloud provider section. Basic is not supported on Azure.
You do not need an account in the deployment environment you choose. The cluster is created on infrastructure managed by Cockroach Labs. For optimal performance, create your cluster on the cloud provider and in the regions that best align with your existing cloud services.
Step 3. Select the regions
In the Regions section, select a region for the cluster. Refer to CockroachDB Cloud Regions for the regions where CockroachDB Basic clusters can be deployed.
For optimal performance, select the cloud provider and region nearest to where your SQL clients, applications, or external data are located. For multi-region clusters, CockroachDB will optimize access to data from the Primary region. Refer to Plan a CockroachDB Basic Cluster to learn more. To express interest in additional regions, contact Support or your Cockroach Labs account team.
To create a multi-region cluster, click Add regions and select additional regions. A cluster can have at most six regions.
You cannot remove a region.
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 Basic clusters on GCP.
Click Next: Capacity.
Step 4. Configure cluster capacity
Your cluster's capacity dictates its resource limits, which are the maximum amount of storage and RUs you can use in a month. Resource limits are optional. If you reach your storage limit, your cluster will be throttled and you may only be able to delete data. If you reach your RU limit, your cluster will be disabled until the end of the billing cycle unless you raise the limit.
Each CockroachDB Cloud organization gets 50M RUs and 10 GiB of storage for free each month. Free resources can be spent across all CockroachDB Basic clusters in an organization. You can set higher resource limits to maintain a high level of performance with larger workloads. You will only be charged for what you use.
The best way to estimate your resource usage is to set resource limits 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.
A typical SELECT query consumes between 1 and 15 RUs, depending on the amount of data it scans and returns. A typical INSERT or UPDATE statement consumes between 10 and 25 RUs, depending on the amount of data it inserts or updates. To estimate the RU consumption of individual SQL statements, you can use the EXPLAIN ANALYZE SQL statement. For an example, see Example Request Unit calculation. For more information, see Planning your cluster.
On the Capacity page, select Start for free.
Note:This will be available only if you haven't already created a free CockroachDB Basic cluster or set up billing information.
Click Next: Finalize.
On the Capacity page, select Upgrade your capacity, even if the option to Start for free is also available.
Configure On-Demand capacity.
- Unlimited: your cluster will scale to meet your application's needs. You will only be charged for the resources you use.
- Set a monthly limit: you can set storage and RU limits individually, or enter a dollar amount that will be split automatically between both resources. You will only be charged for the resources you use.
Click Next: Finalize.
Step 5. Enter billing details
On the Finalize page, verify your cluster and capacity configuration.
Note:The cost displayed does not include taxes and provides a maximum cost estimate. Your final bill will reflect your actual usage.
If you haven't already, add your preferred payment method.
Step 6. 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
- Connect to your CockroachDB Basic cluster
- Manage access
- Learn CockroachDB SQL.
- Explore our example apps for examples on how to build applications using your preferred driver or ORM and run it on CockroachDB.
- Migrate your existing data.
- Build a simple CRUD application in Go, Java, Node.js, or Python.
- For examples of applications that use free CockroachDB Cloud clusters, check out the following Hack the North projects:
Was this helpful?
