Troubleshooting for Helm charts

Learn about troubleshooting steps that you might find helpful if you run into problems managing Helm charts in Artifact Registry.

Can't run Helm commands for charts in OCI format

Support for charts in OCI format is an experimental feature in Helm 3. To turn on this feature, set the HELM_EXPERIMENTAL_OCI variable in the environment.

export HELM_EXPERIMENTAL_OCI=1

Helm commands no longer work in Helm 3.7

Helm 3.7.0 introduced changes to OCI support that are not backwards-compatible, including changed and removed commands for working with registries.

Run helm version to check your Helm version.

Install Helm 3.7.1 or later to use Helm charts with Artifact Registry. Helm 3.7.1 can pull charts in OCI format that were packaged with previous versions of Helm 3.

Helm 3 support for charts saved as OCI container images is experimental. For information about Helm plans for general availability of OCI support, see OCI Support Helm Improvement Proposal