Hyphen
Log In

Remove a Cluster

Learn how to remove a Kubernetes cluster from Hyphen management, including steps for removal and post-removal cleanup.

Remove a cluster when Hyphen should stop managing it. Removal starts a workflow that removes Hyphen management for the cluster.

Table of Contents

Remove From Hyphen

To remove a cluster:

  1. Open Kubernetes.
  2. Select the cluster.
  3. Open the Settings tab.
  4. Find Remove Cluster.
  5. Click Remove.
  6. Type the cluster name to confirm.
  7. Click Remove in the confirmation modal.

Remove Kubernetes cluster confirmation

After removal starts, Hyphen returns you to the Kubernetes cluster list.

Cleanup Needed

If Horizon is still connected, the cluster can enter a Cleanup needed state. In that case, remove Horizon from the cluster, for example by running kubectl delete namespace hyphen-horizon, or wait for it to disconnect, then remove the cluster again from Hyphen.

Things to Know

  • Removing a cluster stops Hyphen from managing that cluster.
  • Removal does not delete your application workloads.
  • You need permission to manage Kubernetes clusters in the organization.
  • If you remove the wrong cluster, reinstall Horizon to register it again.