Helm "cannot re-use a name that is still in use" in CI

By Kaveh Alemi·Latchkey

helm install refuses to create a release whose name already exists. The release is live in this namespace, so installing again would collide with it. You want upgrade, or upgrade --install.

What this error means

helm install fails with "Error: INSTALLATION FAILED: cannot re-use a name that is still in use". helm list shows the release already deployed.

helm

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

Common causes

The pipeline always runs helm install

A CI step hard-codes helm install <name>, so the second deploy collides with the release created by the first.

A release exists in this namespace

A previous run (or another job) already installed a release with that name, and it is still deployed.

How to fix it

Use upgrade --install for idempotent deploys

Install on first deploy, upgrade on every subsequent one, with a single command that is safe to repeat in CI.

Terminal

helm upgrade --install my-app ./chart -n prod --create-namespace

Uninstall first if a clean reinstall is intended

Confirm the existing release with helm list -n prod.
Uninstall it if you really want a fresh install.
Re-run the install.

Terminal

helm uninstall my-app -n prod
helm install my-app ./chart -n prod

How to prevent it

Standardize on helm upgrade --install in deploy pipelines.
Treat release names as stable identifiers, not per-run values.
Check helm list before scripting raw helm install.

Frequently asked questions

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

A CI step hard-codes helm install <name>, so the second deploy collides with the release created by the first.

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