azure/setup-helm "chart version not found" / version resolution failure

By Daniel Zoghalchali·Latchkey

setup-helm downloads the Helm CLI at a requested version. A nonexistent or malformed version pin produces a resolution error before any chart work begins.

What this error means

The setup-helm step fails with "could not find a release for the requested version".

Error: could not find a release for the requested version v9.9.9
##[error]Error: could not find a release for the requested version

Common causes

Nonexistent version pin

The version input names a Helm release that does not exist.

Malformed version string

A missing v prefix or wrong format does not match a published release.

How to fix it

Pin a real, published version

1. Set version to a valid published Helm release (with the v prefix).
2. Or use latest if a fixed pin is not required.
3. Re-run the setup step.

- uses: azure/setup-helm@v4
  with:
    version: v3.15.2

How to prevent it

• Pin tool versions to released tags and review them on upgrade.
• Use the v-prefixed semver format the action expects.

Frequently asked questions

Related guides

References

• GitHub Actions documentation
• Workflow syntax for GitHub Actions