Delete a HCP Consul Dedicated cluster

Warning

HCP Consul Dedicated will be retired on November 12, 2025. Learn more.

Deleting HCP Consul Dedicated clusters removes them from the list of clusters in an HCP project. HashiCorp also deletes all managed resources associated with the cluster. User-managed components, such as services and client agents, lose Consul functionality but are not removed from their cloud environment.

Delete a cluster

Warning

When you delete an HCP Consul Dedicated cluster, the snapshots associated with the cluster are also removed. It is not possible to recover snapshots after they are removed. If you intend to restore a cluster, use an API call to download the snapshot before you delete the cluster. When you restore it, the new cluster’s name must match the name of the deleted cluster.

To delete a HCP Consul Dedicated cluster using HCP, complete the following steps:

Sign in to the HCP Portal.
Select the organization or project where you created the cluster you want to delete.
Click Consul.
From the Consul Overview, next to the cluster you want to delete, click More (three horizontal dots) and then click Delete.
To confirm, enter DELETE. Then click Delete.

Federated networks

When a HCP Consul Dedicated cluster is the primary datacenter in a WAN federated network, HCP does not allow you to delete the cluster if it is still federated with secondary datacenters. Delete all of the secondary datacenters in the federation first, then delete the primary datacenter.

Cluster peering

When you delete a cluster that has an active cluster peering connection with another cluster, HCP removes all data related to the peering connection from clusters. This data includes imported and exported services between clusters. If you recreate a cluster after deleting it, you must complete the full process to re-establish a cluster peering connection, including exporting services and configuring service intentions between clusters.

Refer to Establish cluster peering connections for more information.