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

# Manage BYOC Clusters on StreamNative Cloud

## Prerequisites

Before creating a BYOC instance and clusters, you need to prepare for the BYOC infrastructure. See [BYOC Overview](/cloud/clusters/byoc/byoc-overview) for more information.

After you have prepared the BYOC infrastructure, you can create a BYOC instance and clusters.

## Create a cluster

<Tabs>
  <Tab title="Console">
    You can follow the steps in [Create a BYOC Instance](/cloud/clusters/manage-instances/manage-byoc-instances#create-an-instance) to create a BYOC instance and its first cluster in it.
  </Tab>
</Tabs>

## View cluster details

<Tabs>
  <Tab title="Console">
    Navigate to the **Clusters Dashboard** page.

    * On the **Dashboard** tab, you can view some metrics about the cluster, including the number of topics, subscriptions, consumers, producers, throughput, storage size, and backlog size.
    * On the **Details** tab, you can view the details about the cluster, including the cluster name, location, availability mode, cloud provider, cluster type, service URLs, the features enabled on the cluster, and your Pulsar, BookKeeper, and ZooKeeper versions.
  </Tab>

  <Tab title="snctl">
    To list all the clusters available for an organization, run the following command:

    ```bash theme={null}
    snctl get pulsarclusters -O <your-org-id>
    ```

    If you want to get more details about a cluster, you can run the following command:

    ```bash theme={null}
    snctl get pulsarcluster <your-cluster-name> -O <your-org-id>
    ```
  </Tab>

  <Tab title="Terraform">
    If you want to get more details about a cluster, you can define a data source in the Terraform configuration file.

    ```hcl theme={null}
    data "streamnative_pulsar_cluster" "test-cluster" {
      organization = "<your-organization>"
      name = "<your-cluster-name>"
    }
    ```

    You can checkout [PulsarCluster](https://registry.terraform.io/providers/streamnative/streamnative/latest/docs/data-sources/pulsar_cluster) for more information.
  </Tab>
</Tabs>

## Update a cluster

<Tabs>
  <Tab title="Console">
    1. Navigate to the **Cluster Dashboard** page.

    2. Click **Configuration** at the left navigation pane.

    3. On the **Cluster Configuration** page, you can click **Edit Cluster** button to update the cluster.

    4. On the **Cluster Operations** page, you can update the cluster:

       * **Release Channel**: Currently, it doesn't support switching the release channel after the cluster is created.
       * **Features**: You can enable or disable features on the cluster.
       * **Custom Configuration**: You can update the custom configuration of the cluster.

    5. After update the cluster settings, click **Cluster Size** to change the cluster size.

       You can use **Basic** or **Advanced** tabs to update the cluster size based on your needs.

    6. Click **Finish** when you are done updating your cluster.
  </Tab>
</Tabs>

## Delete a cluster

<Note title="Note">
  You cannot delete a cluster if there are resources associated with the cluster.
</Note>

<Tabs>
  <Tab title="Console">
    1. Navigate to the **Clusters** page.

    2. Click the ellipsis at the top right corner of the cluster card that you want to delete, and then click **Delete**.

    3. In the **Are you sure you want to delete this?** dialog, enter the cluster name and then click **Confirm**.
  </Tab>

  <Tab title="snctl">
    There are two ways to delete a cluster.

    * Delete the cluster by the cluster name.

      ```bash theme={null}
      snctl delete pulsarcluster <your-cluster-name>
      ```

    * Delete the cluster by the cluster manifest file `cluster.yaml`.

      ```bash theme={null}
      snctl delete -f cluster.yaml
      ```
  </Tab>

  <Tab title="Terraform">
    Remove the cluster resource from the Terraform configuration file and run `terraform apply` to delete the cluster.
  </Tab>
</Tabs>