<a id="usm-deregister-connect"></a>

# Deregister a Connect Cluster from USM

When you deregister a Connect cluster, Confluent Cloud removes it as a Unified Stream Manager
(USM) entity.

The USM Agent continues to run in your self-managed environment and
emits events, but Confluent Cloud rejects them because the cluster no longer has a
corresponding mapping in Confluent Cloud.

To stop these events, remove the USM-specific configuration from
the Connect cluster. After you remove the configuration, you can remove
the USM Agent if no other Kafka or Connect cluster is using the agent.

This page describes how to deregister a Connect cluster that’s registered
against either a Confluent Platform Kafka cluster or a Confluent Cloud Kafka cluster.

### Confluent Cloud Console

**For a Confluent Platform Kafka cluster**

1. In the Confluent Cloud Console, navigate to **Environments** and
   select your environment.
2. In the navigation menu, click **Clusters** and select your Confluent Platform
   cluster.
3. In the navigation menu, click **Connectors**.
4. On the **Connectors** page, click **Connect cluster list**.
   ![Connectors page showing the Connect cluster list button](images/usm-connect-deregister-connectors.png)
5. In the **Connect cluster list** panel, locate the Connect
   cluster to deregister. You can search by name or Confluent Cloud
   ID, or sort the list by clicking a column header.
   ![Connect cluster list panel showing registered Connect clusters](images/usm-connect-deregister-panel.png)
6. In the row for the cluster to deregister, click **Deregister**.
7. In the **Deregister Connect cluster** dialog, enter the cluster
   name exactly as shown.
   ![Deregister Connect cluster confirmation dialog](images/usm-connect-deregister-dialog.png)
8. Click **Deregister**.

Confluent Cloud removes the cluster from the **Connect cluster list**.

**For a Confluent Cloud Kafka cluster**

1. In the Confluent Cloud Console, navigate to **Environments** and
   select your environment.
2. In the navigation menu, click **Clusters**, click **Confluent
   Cloud**, and select your Confluent Cloud Kafka cluster.
3. In the navigation menu, click **Connectors**, and then click
   **Self-managed**.
4. On the **Connectors** page, click **Connect cluster list**.
5. In the **Connect cluster list** panel, locate the Connect
   cluster to deregister. You can search by name or Confluent Cloud
   ID, or sort the list by clicking a column header.
   ![Connect cluster list panel showing registered Connect clusters](images/usm-connect-deregister-panel-cloud.png)
6. In the row for the cluster to deregister, click **Deregister**.
7. In the **Deregister Connect cluster** dialog, enter the cluster
   name exactly as shown.
   ![Deregister Connect cluster confirmation dialog](images/usm-connect-deregister-dialog-cloud.png)
8. Click **Deregister**.

Confluent Cloud removes the cluster from the **Connect cluster list**.

### Confluent CLI

1. Log in to the Confluent CLI.
   ```bash
   confluent login
   ```
2. Get the **Environment ID** using the following steps:
   1. In the Confluent Cloud Console, navigate to **Environments** and
      select your environment.
   2. Click **Details** and copy the ID from the **About**
      section.
3. Run the list command to see all USM registered Connect
   clusters in your environment. This allows you to find the specific
   `USM_CONNECT_CLUSTER_ID` required for deregistration.
   ```bash
   confluent usm connect-cluster list --environment <YOUR_ENVIRONMENT_ID>
   ```

   From the output, identify the Connect cluster you want to remove
   and copy its ID.
   A `USM_CONNECT_CLUSTER_ID` always starts with the prefix `usmcc-`.
4. Use the `confluent usm connect-cluster deregister` command with
   the `usmcc-` ID you copied. You can pass more than one ID to
   deregister multiple Connect clusters at once.
   ```bash
   confluent usm connect-cluster deregister <USM_CONNECT_CLUSTER_ID> --environment <YOUR_ENVIRONMENT_ID>
   ```

   The following example deregisters a Connect cluster with the ID
   `usmcc-abc123` in the environment `env-12345`.
   ```bash
   confluent usm connect-cluster deregister usmcc-abc123 --environment env-12345
   ```
5. The CLI prompts you for confirmation. Type `y` and press
   **Enter** to proceed. To skip this prompt, add the `--force`
   flag to the command.
   ```text
   Are you sure you want to deregister USM Connect cluster "usmcc-abc123"? (y/n): y
   Deregistered USM Connect cluster "usmcc-abc123".
   ```

After deregistration, the corresponding Connect cluster card is
removed from the Confluent Cloud Console.

For a complete reference of related commands, see the [confluent usm
CLI documentation](https://docs.confluent.io/confluent-cli/current/command-reference/usm/index.html#confluent-usm).

## Related content

* [Confluent Platform Kafka as the Metadata Cluster](platform-kafka.md#register-connect)
* [Confluent Cloud Kafka as the Metadata Cluster](cloud-kafka.md#register-connect-cloud)
* [Unified Stream Manager in Confluent Cloud](../overview.md#cloud-usm-overview)
* [Monitor Confluent Platform Connectors with USM](../monitor/connectors.md#platform-connectors)
* [Monitor Self-Managed Connectors Running Against Confluent Cloud Kafka](../monitor/connectors-cloud-kafka.md#platform-connectors-cloud)
* [Remove the USM Agent](../remove-agent.md#usm-remove-agent)
