# Helm v3.22.0

2026-09-10 · [Original release notes](https://github.com/helm/helm/releases/tag/v3.22.0) · [Full summary](https://ratatosk.io/en/releases/helm/v3.22.0)

Security 4 · Breaking changes 1 · Important fixes 3 · Dependency updates 30 · Other changes 32

## Check before upgrading

### Known issues

- **Linux loong64 binary download unavailable**: The listed download URL returns a `BlobNotFound` error because the referenced blob does not exist.
  > - [Linux loong64](https://get.helm.sh/helm-v3.22.0-linux-loong64.tar.gz) ([checksum](https://get.helm.sh/helm-v3.22.0-linux-loong64.tar.gz.sha256sum) / ﻿<?xml version="1.0" encoding="utf-8"?><Error><Code>BlobNotFound</Code><Message>The specified blob does not exist.
  > RequestId:8c31497a-101e-0042-27b6-404cb4000000
  > Time:2026-09-09T23:55:30.1192401Z</Message></Error>)

### Upgrade guide

- **Quickstart and installation instructions**
  > The [Quickstart Guide](https://helm.sh/docs/intro/quickstart/) will get you going from there. For **upgrade instructions** or detailed installation notes, check the [install guide](https://helm.sh/docs/intro/install/). You can also use a [script to install](https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-4) on any system with `bash`.

## Security (4)

### IDNA Punycode validation fixed in `golang.org/x/net`

- Affects: Helm operations that convert Punycode-encoded labels (Inferred)
- [CVE-2026-39821](https://www.cve.org/CVERecord?id=CVE-2026-39821), [GO-2026-5026](https://osv.dev/vulnerability/GO-2026-5026)

Before the update, `ToUnicode` returned `example.com` instead of an error for `xn--example-.com`, a Punycode-encoded label that decodes to an ASCII-only label.

> - fix(deps): bump golang.org/x/net to v0.55.0 to address GO-2026-5026 1dde6c7551746a74a6f69db06eaf4fc58a90042b (Terry Howe)

### Provenance migrated to `ProtonMail/go-crypto`

- Affects: Helm setups using provenance functionality (Inferred)
- [GO-2026-5932](https://osv.dev/vulnerability/GO-2026-5932)

> - fix(provenance): migrate to ProtonMail/go-crypto to resolve GO-2026-5932 bd392c6a60d09a6c9f467dc52dbfd249a641f80d (Karan V)

### containerd v1 dependency removed from Helm

- Affects: Helm v3.22.0 installations (Inferred)

> - fix: drop containerd v1 dep to resolve govulncheck CVEs a061886b724181526f5283789e78ec4369e25ff3 (Benoit Tigeot)

### Registry credentials retained on plain-HTTP fallback

- Affects: registry operations using a plain-HTTP fallback (Inferred)

> - fix(registry): keep credentials on plain-HTTP fallback with oras-go v2.6.1 2fb05f8a35f6c0d5760c03c12d60c46adf2b3d12 (Terry Howe)

## Breaking changes (1)

### Helm's reported version changed to `v3.21`

- Affects: Helm installations that report their version (Inferred)

Version reporting previously used `v3.20`.

Evidence: “- version = "v3.20" + version = "v3.21"” https://github.com/helm/helm/pull/32103

> - [v3] Bump to version v3.21 (#32103) 3033a778b611b7501dffae7bd57c071dde318b6c (George Jenkins)

## Important fixes (3)

### `[pull,push]` scope hint added to token-authenticated `helm push`

- Affects: Helm setups that push to a registry using token authentication

> - fix: set [pull,push] scope when helm push to a registry(use token auth) (backport) (#32362) 9dbcb9f1edb4cdf2b055870dc9a07e0c0f4b05d1 (kimsungmin1)

### Empty-file handling fixed in `Files.Lines`

- Affects: Helm setups using `Files.Lines` (Inferred)

`Files.Lines` could panic when given an empty file; that call no longer panics.

> - fix(engine): prevent Files.Lines panic on empty file c02a9aed3452c0c7ee9d79ded44dd170ce5001ca (Mahesh Sadupalli)
> - Apply suggestions from code review 093015b3b7c466828d01697d4d3d8f4811c59942 (Benoit Tigeot)

### Nil REST client getter panic avoided during CRD installation

- Affects: Helm installations that install CRDs (Inferred)

> - fix(action): avoid nil REST client getter panic when installing CRDs 711a4eaf40a911b0864a01b99f59f62817443003 (sergiochan)

## Dependency updates (30)

30 more, none mentioning security

- `- primarily dependency updates and k8s-io group to 0.37.0`
- `- chore(deps): bump the k8s-io group across 1 directory with 6 updates 144ca65f8501953fa8b41cd1d37c7223051c85b7 (dependabot[bot])`
- `- chore(deps): bump the k8s-io group with 7 updates (#32573) 0841093658d96f4787cc9599cd2a891a3c590971 (dependabot[bot])`
- `- chore(deps): bump github.com/stretchr/testify from 1.12.0 to 1.12.1 (#32563) d0569c7d625151ee8c7b858d87218dd06087d613 (dependabot[bot])`
- `- chore(deps): bump github.com/stretchr/testify from 1.11.1 to 1.12.0 (#32554) 6cdcc8f91de2dbe181b19be8f5de0701b9c30acd (dependabot[bot])`
- `- chore(deps): bump golang.org/x/crypto from 0.54.0 to 0.55.0 (#32542) 158719fb4346eb65ee789abc09a922a84bf6ec3b (dependabot[bot])`
- `- chore(deps): bump github.com/santhosh-tekuri/jsonschema/v6 1c50d2f8bde0738c7f6df584d77fb469ec52848d (dependabot[bot])`
- `- chore(deps): bump the k8s-io group with 7 updates 66a6f5601d26bb640e0de5f877268a48de2148dd (dependabot[bot])`
- `- chore(deps): bump oras.land/oras-go/v2 from 2.6.1 to 2.6.2 (#32331) b842ddfccba6a388df1dd2f959d16db3ce105e16 (dependabot[bot])`
- `- chore(deps): bump github.com/mattn/go-shellwords from 1.0.13 to 1.0.14 (#32332) f6047c96c7a83f8004752f0be201e03181d3ef59 (dependabot[bot])`
- `- chore(deps): bump golang.org/x/text from 0.38.0 to 0.40.0 (#32310) 8082dd4a0d9f1ca3dbd2052a8b0e1bba843a85c7 (dependabot[bot])`
- `- chore(deps): bump golang.org/x/crypto from 0.53.0 to 0.54.0 (#32308) 2c24490679681b0825c258576e9f7699f8dc8e54 (dependabot[bot]) [earlier release v3.21.4]`
- `- chore(deps): bump golang.org/x/term from 0.44.0 to 0.45.0 (#32306) 953d280f928c4bc76912236bc2a8a0d11a39c016 (dependabot[bot])`
- `- chore(deps): bump github.com/containerd/containerd from 1.7.32 to 1.7.33 f9798360983d9d964e2088427c693317a69f326e (dependabot[bot])`
- `- chore(deps): bump github.com/cyphar/filepath-securejoin c4446659f68e94db06f0e142376f8cf1b970a878 (dependabot[bot])`
- `- chore(deps): bump the k8s-io group with 2 updates 1bf9b5fbba4df88a562a35eef40e6c60f12b5a90 (dependabot[bot])`
- `- chore(deps): bump the k8s-io group across 1 directory with 2 updates 119a7d9babffcec9e51d285153e09d8c4f54a69d (dependabot[bot])`
- `- chore(deps): bump oras.land/oras-go/v2 from 2.6.0 to 2.6.1 acc867b88e68e5f9c074c1c8c584a57b3ae6c127 (dependabot[bot])`
- `- chore(deps): bump golang.org/x/crypto from 0.52.0 to 0.53.0 b920935feb6b6c8729cdf6b98f4c8efc824779c5 (dependabot[bot])`
- `- chore(deps): bump golang.org/x/term from 0.43.0 to 0.44.0 5b5ef192c773f6448e4dcd845e643c573aff906b (dependabot[bot])`
- `- chore(deps): bump golang.org/x/text from 0.37.0 to 0.38.0 af67af8951d5f9a7631efc3a97b6dc6b58247148 (dependabot[bot])`
- `- chore: bump go to 1.26 c678c0c9c088fc2f9ddbad8c88416c77f4e048cc (Terry Howe)`
- `- chore(deps): bump github.com/lib/pq from 1.11.2 to 1.12.3 12c4d45b146a8be1ca70bd15e3cad00e7d12733a (dependabot[bot])`
- `- chore(deps): bump github.com/distribution/distribution/v3 a0f97111f5607a5724a8af110480384827a81b41 (dependabot[bot])`
- `- chore(deps): bump github.com/containerd/containerd from 1.7.30 to 1.7.32 995c31e20bf3ab9a4feb85cd4a54951d9418ea51 (dependabot[bot])`
- `- chore(deps): bump github.com/Masterminds/semver/v3 from 3.4.0 to 3.5.0 8c171688281d3c1f14d908cf682c742585848db0 (dependabot[bot])`
- `- chore(deps): bump github.com/mattn/go-shellwords from 1.0.12 to 1.0.13 fe141bd537ea42e64bec3b3b181dcf955260e939 (dependabot[bot])`
- `- chore(deps): bump golang.org/x/crypto from 0.51.0 to 0.52.0 980836f726fdfbd6a2f0662a0aa48fe35da3fd64 (dependabot[bot])`
- `- chore(deps): bump k8s.io/klog/v2 from 2.130.1 to 2.140.0 0162feda1d4d6dd0bd1f227ecdfe9f489e6d7284 (dependabot[bot])`
- `- chore(deps): bump golang.org/x/text from 0.35.0 to 0.37.0 a664a58f43c742987376bca589891fda3bf55668 (dependabot[bot])`

## Other changes (32)

- Helm project version bumped to 3.22
- Four GitHub Actions dependencies updated in one directory
- Four GitHub Actions dependencies updated in one directory
- Four GitHub Actions dependencies updated
- Four GitHub Actions dependencies updated
- GitHub Actions dependency updates
- GitHub `actions/stale` Action updated
- Updated `ossf/scorecard-action`
- Four GitHub Actions dependencies updated
- `github/codeql-action/upload-sarif` updated
- `actions/labeler` updated to 7.0.0
- `github/codeql-action/analyze` updated to 4.37.2
- `github/codeql-action/autobuild` updated to 4.37.2
- `github/codeql-action/init` updated from 4.37.1 to 4.37.2
- `actions/checkout` updated to 7.0.1
- Updated `github/codeql-action/autobuild` to 4.37.1
- `actions/setup-go` updated to 7.0.0
- CodeQL SARIF upload action updated
- Automatic `v3.x` labeling for pull requests to `dev-v3`
- `github/codeql-action/analyze` updated from 3.26.6 to 4.37.0
- GitHub Actions `actions/checkout` dependency updated to 7.0.0
- GitHub Actions `actions/stale` dependency updated to 10.4.0
- GitHub Actions `setup-go` dependency updated to 6.5.0
- GitHub Actions workflow dependency `github/codeql-action/upload-sarif` updated
- GitHub Actions workflow dependency `github/codeql-action/init` updated to 4.37.0
- GitHub Actions dependency `golang/govulncheck-action` updated from 1.0.4 to 1.1.0
- GitHub Actions workflow updates `golangci/golangci-lint-action` to 9.3.0
- GitHub Actions workflow updates `ossf/scorecard-action` to 2.4.3
- Helm fix
- `.github/env` updated
- CI `golangci-lint` updated to v2.11.3 for Go 1.26
- Helm rollback for missing resources fixed

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
