Helm "INSTALLATION FAILED: cannot re-use a name that is still in use"

By Kaveh Alemi·Latchkey

A Helm release name is unique per namespace. Running helm install with a name that already has a deployed release collides; the pipeline should upgrade that release instead of installing a new one.

What this error means

A helm install step fails with "INSTALLATION FAILED: cannot re-use a name that is still in use", because a release of that name already exists in the namespace.

helm

Error: INSTALLATION FAILED: cannot re-use a name that is still in use

Common causes

Release already installed

A prior run already installed the release; a second install collides instead of upgrading.

install used where upgrade is intended

CI hard-codes helm install for both first deploy and subsequent deploys.

How to fix it

Use upgrade --install

Make the deploy idempotent: install on first run, upgrade thereafter.

Terminal

helm upgrade --install api ./chart -n prod --wait

Or remove the stale release first

Check existing releases with helm list -n prod.
If the release is genuinely orphaned, helm uninstall api -n prod then reinstall.
Prefer upgrade --install to avoid this entirely.

How to prevent it

Standardize on helm upgrade --install in pipelines.
Use one release name per app per namespace.
List releases before deploy to catch leftovers.

Frequently asked questions

What causes ""cannot re-use a name that is still in use""?

A prior run already installed the release; a second install collides instead of upgrading.

How do I fix "cannot re-use a name that is still in use"?