> ## Documentation Index
> Fetch the complete documentation index at: https://cockroachlabs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a CockroachDB Basic Cluster

export const InternalLink = ({version, path = "", children, ...props}) => {
  let detectedVersion = version || "stable";
  if (typeof window !== 'undefined' && !version) {
    const match = window.location.pathname.match(/\/docs\/([^/]+)/);
    if (match) {
      detectedVersion = match[1];
    }
  }
  const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
  return <a href={`/docs/${detectedVersion}/${normalizedPath}`} {...props}>
      {children}
    </a>;
};

This page guides you through the process of creating a cluster using CockroachDB Basic. Note that only <InternalLink path="authorization#organization-admin">CockroachDB Cloud Organization Admins</InternalLink> 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 <InternalLink path="upgrade-cockroach-version">upgraded</InternalLink> to new patch versions, as well as new major versions, to maintain uninterrupted support and SLA guarantees. For more details, refer to <InternalLink path="upgrade-policy">CockroachDB Cloud Upgrade Policy</InternalLink>.

## Before you begin

If you haven't already, [sign up for a CockroachDB Cloud account](https://cockroachlabs.cloud/signup?referralId=docs_create_account).

<Note>
  Organizations without billing information on file can only create one CockroachDB Basic cluster.
</Note>

## Step 1. Start the cluster creation process

1. If you haven't already, [sign up for a CockroachDB Cloud account](https://cockroachlabs.cloud/signup?referralId=docs_create_account), then [log in](https://cockroachlabs.cloud/).

<Note>
  We recommend that CockroachDB Cloud Console users log in with <InternalLink version="cockroachcloud" path="cloud-org-sso">Single Sign-On (SSO)</InternalLink>, 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 <InternalLink version="cockroachcloud" path="cloud-org-sso#basic-sso">Basic SSO</InternalLink> supports SSO with GitHub, Google, and Microsoft. <InternalLink version="cockroachcloud" path="cloud-org-sso#cloud-organization-sso">Cloud Organization SSO</InternalLink> 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](https://cockroachlabs.cloud/account/profile) and switch to SSO to improve the security of your cluster.
</Note>

2. If there are multiple <InternalLink version="stable" path="architecture/glossary#organization">organizations</InternalLink> in your account, verify the one that is selected in the top right corner.
3. On the **Clusters** page, click **Create Cluster** or, if you also have permission to create folders, then click **Create > Create Cluster**.
4. 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 <InternalLink path="regions">CockroachDB Cloud Regions</InternalLink> 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 <InternalLink version="stable" path="multiregion-overview">**Primary region**</InternalLink>. Refer to <InternalLink path="plan-your-cluster-basic#multi-region-clusters">Plan a CockroachDB Basic Cluster</InternalLink> to learn more. To express interest in additional regions, [contact Support](https://support.cockroachlabs.com/) 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.

<Note>
  You cannot remove a region.
</Note>

After creating a multi-region cluster deployed on AWS, you can optionally <InternalLink path="network-authorization">set up AWS PrivateLink (Limited Access)</InternalLink> 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 <InternalLink version="cockroachcloud" path="basic-cluster-management#edit-cluster-capacity">set resource limits</InternalLink> 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 <InternalLink version="cockroachcloud" path="basic-cluster-management#view-cluster-overview">**Cluster Overview**</InternalLink> page. Once enough usage data is available, you can also see a graph of your monthly resource usage and recommended spend limit on the <InternalLink version="cockroachcloud" path="basic-cluster-management#edit-cluster-capacity">**Edit cluster**</InternalLink> 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 <InternalLink version="stable" path="explain-analyze">`EXPLAIN ANALYZE`</InternalLink> SQL statement. For an example, see <InternalLink version="cockroachcloud" path="resource-usage#example-request-unit-calculation">Example Request Unit calculation</InternalLink>. For more information, see <InternalLink path="plan-your-cluster">Planning your cluster</InternalLink>.

1. 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.
</Note>

2. Click **Next: Finalize**.

3. On the **Capacity** page, select **Upgrade your capacity**, even if the option to **Start for free** is also available.

4. 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.

5. Click **Next: Finalize**.

## Step 5. Enter billing details

1. 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.
</Note>

2. If you haven't already, add your preferred <InternalLink path="billing-management">payment method</InternalLink>.

## 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

* <InternalLink path="connect-to-your-cluster">Connect to your CockroachDB Basic cluster</InternalLink>
* <InternalLink path="managing-access">Manage access</InternalLink>
* Learn <InternalLink version="stable" path="sql-statements">CockroachDB SQL</InternalLink>.
* <InternalLink version="molt" path="migration-overview">Migrate your existing data</InternalLink>.
* Build a simple CRUD application in <InternalLink version="stable" path="build-a-go-app-with-cockroachdb">Go</InternalLink>, <InternalLink version="stable" path="build-a-java-app-with-cockroachdb">Java</InternalLink>, <InternalLink version="stable" path="build-a-nodejs-app-with-cockroachdb">Node.js</InternalLink>, or <InternalLink version="stable" path="build-a-python-app-with-cockroachdb">Python</InternalLink>.
* For examples of applications that use free CockroachDB Cloud clusters, check out the following [Hack the North](https://hackthenorth.com/) projects:
  * [flock](https://devpost.com/software/flock-figure-out-what-film-to-watch-with-friends)
  * [mntr.tech](https://devpost.com/software/mntr-tech)
  * [curbshop.online](https://devpost.com/software/curbshop-online)
