Helm CLI For Red Hat OpenShift Compatibility Matrix
This article lists the compatible versions of Helm CLI for Red Hat OpenShift, Red Hat OpenShift Container Platform, and Kubernetes.
It is not a lifecycle support policy — for support dates and lifecycle phases, refer to:
Contents
Helm CLI Compatibility Matrix
This matrix is based on the OpenShift Kubernetes version alignment and upstream Content from helm.sh is not included.Helm project skew policies(external).
| OpenShift Version | Kube Version | Helm CLI v3 | Helm CLI v4 |
|---|---|---|---|
| OCP 4.22 | 1.35 | v3.20 - v3.21 | v4.1 - v4.2 |
| OCP 4.21 | 1.34 | v3.19 - v3.21 | Not Supported |
| OCP 4.20 | 1.33 | v3.18 - v3.21 | Not Supported |
| OCP 4.19 | 1.32 | v3.17 - v3.20 | Not Supported |
| OCP 4.18 | 1.31 | v3.16 - v3.19 | Not Supported |
| OCP 4.17 | 1.30 | v3.15 - v3.18 | Not Supported |
| OCP 4.16 | 1.29 | v3.14 - v3.17 | Not Compatible |
| OCP 4.15 | 1.28 | v3.13 - v3.16 | Not Compatible |
| OCP 4.14 | 1.27 | v3.12 - v3.15 | Not Compatible |
| OCP 4.13 | 1.26 | v3.11 - v3.14 | Not Compatible |
| OCP 4.12 | 1.25 | v3.10 - v3.13 | Not Compatible |
Helm v3 to Helm v4 Transition and Coexistence
Red Hat aligns with the upstream Helm project's architectural migration path from Helm v3 to Helm v4. Because the Helm CLI is a client-side execution tool, Red Hat establishes the following commercial and technical support boundaries for customers transitioning major versions:
-
Side-by-Side Coexistence: Helm v3 and Helm v4 binaries can be used independently and concurrently, targeting different chart releases in the same Red Hat OpenShift cluster. Upgrading a cluster's OpenShift version does not force an immediate conversion of existing Helm v3 releases to Helm v4. However, once a given release has been created or updated using Helm v4, it should not be targeted by operations using Helm v3.
-
Chart Compatibility & Execution: Red Hat supports the execution of both Helm v3 and Helm v4 binaries shipped via official channels. Helm v4 supports both the existing chart schema (
v2) and the new chart schema (v3) being introduced upstream. For details on chart schema versions, refer to the Content from helm.sh is not included.upstream Helm documentation(external). Chart compatibility — including adaptation to the new schema, deprecated API removals, and structural changes — is the responsibility of the chart maintainer. -
Data Migration: Customers choosing to migrate existing release state from Helm v3 to Helm v4 should follow the migration guidance provided by the upstream Helm project. For chart-specific migration considerations, refer to the chart vendor's documentation.
Disclaimer: Links contained herein to external website(s) are provided for convenience only. Red Hat has not reviewed the links and is not responsible for the content or its availability. The inclusion of any link to an external website does not imply endorsement by Red Hat of the website or its entities, products, or services. You agree that Red Hat is not responsible or liable for any loss or expenses that may result due to your use of (or reliance on) the external site or content.