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

# Manage 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 describes the cluster management and cluster deletion workflows for CockroachDB Basic.

## View Clusters page

On [logging in to the CockroachDB Cloud Console](https://cockroachlabs.cloud/), the **Clusters** page is displayed. The **Clusters** page provides a high-level view of your clusters.

To view and manage a specific cluster, click the name of the cluster. The [**Overview**](#view-cluster-overview) page will display.

## View cluster overview

The **Overview** page displays details about the selected CockroachDB Basic cluster. For more information, see <InternalLink version="cockroachcloud" path="overview-page">Overview Page</InternalLink>.

Click the **Connect** button to get client connection details for your cluster. For more information, see <InternalLink version="cockroachcloud" path="connect-to-a-basic-cluster">Connect to Your CockroachDB Cluster</InternalLink>.

## Edit labels

You can <InternalLink path="labels">organize CockroachDB Cloud clusters using labels</InternalLink>.

## Estimate usage cost

<Note>
  This feature is not available if your organization is billed through <InternalLink path="billing-management">Credits</InternalLink>.
</Note>

The monthly cost estimate is calculated using simple extrapolation that assumes your workload during the selected time frame is an accurate representation of your workload over the month. If you haven't been running a workload for at least the length of the selected time frame, your results will be inaccurate.

1. Click on the three-dots menu and select **Edit cluster**.

   The **Edit cluster** page displays.

2. Click on **Next: Capacity** to open the **Capacity** page.

3. Under the **Estimate cost based on usage** section, select a time period in which your workload was active.

   Your used <InternalLink path="plan-your-cluster-basic#request-units">RUs</InternalLink>, used storage, and accrued costs during the time period will be shown along with a monthly cost estimate. The accrued costs and monthly cost estimate do not account for the <InternalLink path="plan-your-cluster-basic#free-vs-paid-usage">\$15 of free resources each month</InternalLink> granted to each organization (excluding those with annual or multi-year contracts), which you would have to use up before being charged.

## Edit cluster capacity

The price-performance characteristics of CockroachDB Basic vary significantly depending on the workload. It can be difficult to estimate a workload's compute requirements in advance. With Basic, by default compute and storage scale with your cluster's needs, but you can limit a cluster's resource usage:

1. Click on the three-dots menu and select **Edit cluster**.

   The **Edit cluster** page displays.

2. Click on **Next: Capacity** to open the **Capacity** page.

3. On the **Capacity** page, edit the resource limits. In the sidebar, click **Update cluster**.

Changes apply to the current and future billing cycles. For more details, refer to <InternalLink path="plan-your-cluster-basic">Plan a CockroachDB Basic cluster</InternalLink>.

## Edit regions

You can add up to six <InternalLink path="regions">regions</InternalLink> at a time and change your <InternalLink path="plan-your-cluster-basic#multi-region-clusters">primary region</InternalLink> through the Cloud Console. You cannot currently edit the region configuration for a single-region cluster once it has been created, and you cannot remove a region once it has been added.

<Note>
  You can only add regions to clusters created after May 16, 2023.
</Note>

### Add regions

To add regions to your cluster:

1. Navigate to the cluster's **Overview** page.
2. Click on **Settings** to expand the **Cluster settings** section, then click on **Edit** next to the cluster's **Regions**.

   The **Edit cluster** page displays.
3. Click **Add region**.
4. Choose the region you want to add or use the suggested one.
5. In the sidebar, verify the hourly estimated cost for the cluster.
6. Click **Next: Capacity** and then click **Update cluster**.

### Edit the primary region

To set the primary region:

1. Navigate to the cluster's **Overview** page.
2. Click on **Settings** to expand the **Cluster settings** section, then click on **Edit** next to the cluster's **Regions**.

   The **Edit cluster** page displays.
3. Select **Set primary region** next to your preferred region.
4. Click **Next: Capacity** and then click **Update cluster**.

### Move cluster to a new region

A CockroachDB Basic cluster cannot be moved from one region to another directly. Instead, you must restore the cluster's data from a backup to a new CockroachDB Basic cluster with the desired region configuration:

1. <InternalLink path="take-and-restore-self-managed-backups">Back up your existing cluster's data</InternalLink>.
2. <InternalLink path="create-a-basic-cluster">Create a new CockroachDB Basic cluster</InternalLink> in the desired region.
3. Once the new cluster is set up, <InternalLink path="take-and-restore-self-managed-backups">restore your data</InternalLink> from the backup into the new cluster.

## Change a cluster's plan

To change your cluster's plan between Basic and Standard, refer to <InternalLink path="change-plan-between-basic-and-standard">Change a Cluster's Plan Between Standard and Basic</InternalLink>.

To change from Basic to Advanced, refer to <InternalLink path="migrate-from-standard-to-advanced">Migrate from Standard or Basic to Advanced</InternalLink>.

## Restore data from a backup

Use the <InternalLink path="managed-backups">Managed Backups</InternalLink> to restore your cluster from automatic full cluster backups.

You can also <InternalLink path="take-and-restore-self-managed-backups">back up and restore</InternalLink> your CockroachDB Basic cluster manually. You can take <InternalLink path="take-and-restore-self-managed-backups">backups locally</InternalLink> to <InternalLink version="stable" path="use-userfile-storage">`userfile`</InternalLink> or <InternalLink path="take-and-restore-self-managed-backups">back up to cloud storage</InternalLink>.

## Enable deletion protection

To help prevent a cluster from being deleted by mistake, you can enable *deletion protection*. Before you can delete a cluster with deletion protection enabled, you must disable deletion protection. A user with permission to delete a cluster can enable deletion protection on the same cluster.

1. Navigate to the **Overview** page for the cluster you want to protect.
2. Click on **Settings** to open the **Cluster settings** panel.
3. If deletion protection is off, click **Edit**. Toggle the setting, then click **Save**.

## Delete cluster

<Danger>
  Deleting a cluster will delete all cluster data.
</Danger>

<Note>
  Free CockroachDB Basic clusters are subject to deletion after 6 months of no activity. Deleted clusters can not be restored.
</Note>

Proceed with the following steps only if you are sure you want to delete a cluster:

1. Turn off [deletion protection](#enable-deletion-protection) if it is enabled.
2. Click on the three-dots menu.
3. Select **Delete cluster**.
4. In the confirmation window, enter the name of the cluster.
5. Click **Delete**.