Helm prevents reusing a release name that is still being tracked, even if the resources are deleted.
Fixes cannot re-use a name that is still in use
helm list -n NAMESPACE
helm history RELEASE_NAME -n NAMESPACEhelm list -n NAMESPACEhelm history RELEASE_NAME -n NAMESPACEcannot re-use a name that is still in use
Helm maintains release metadata independent of actual resources. Deleting resources from the cluster doesn't remove the release from Helm's tracking. To reuse a name, you must either fully delete the release or use a different name.
Check if release is tracked by Helm:
helm list -n NAMESPACE
helm history RELEASE_NAME -n NAMESPACEFully remove the release:
helm delete RELEASE_NAME -n NAMESPACEVerify it's gone:
helm list -n NAMESPACEThere may be a grace period for deletion:
sleep 10
helm list -n NAMESPACEEnsure release no longer appears.
Now you can reuse the name:
helm install RELEASE_NAME CHART_NAME -n NAMESPACE --create-namespaceFor CI/CD, use unique release names:
helm install RELEASE_NAME-${BUILD_ID} CHART_NAMEOr use helm upgrade --install for idempotency:
helm upgrade --install RELEASE_NAME CHART_NAMEAlways use helm delete to remove releases—never manually delete resources. For production, use GitOps tools that manage releases declaratively (ArgoCD, Flux). Keep release names stable; use the same name across deployments. Consider using namespaces to isolate release names. Monitor release state with monitoring/alerting on helm list output.