Installing a Helm Chart from a Release
When a release includes a Helm chart, its page has a Helm section with the commands to install and upgrade it. This page explains them. For other chart commands (helm pull, version ranges) see Helm Charts and OCI Artifacts.
Log in
Helm uses your pull token, the same one as docker login. Create one on the Tokens page, then run the command from the release page with your token's username:
helm registry login registry.breakwaterapp.com --username <username>
Helm asks for the password: paste the token secret.
Install and upgrade
The release page fills in the chart's location and digest. Type a release name (it defaults to the chart's name) and, if you want one, a namespace; tick the box that appears to add --create-namespace. The commands and their copy buttons update as you type. Names must be lowercase letters, digits and -.
helm install web oci://registry.breakwaterapp.com/acme/charts/web@sha256:3f1c… --namespace apps --create-namespace
helm upgrade web oci://registry.breakwaterapp.com/acme/charts/web@sha256:3f1c… --namespace apps
Commands pin the chart's digest, so you install exactly the chart this release recorded, even if the vendor has pushed a different chart under the same version since. Use a current Helm 3 release, which accepts digest references; the chart's version is shown next to its name. If the release has several charts with the same name, each gets a different default release name.
If the release ships a Helm values file, the section links it. Download it, edit it, and tick Use the release's values file to add --values <file> to the commands.
To move to a newer release, open that release's page and run its helm upgrade.
Without internet access
If the cluster can't reach the internet, bundle the release and load it into your own registry, as described in Air-Gapped Installs:
breakwater bundle load acme-web-1.2.3.bwbundle.tar --registry registry.internal.example.com
helm install web oci://registry.internal.example.com/acme/charts/web@sha256:3f1c…
The release page shows this under Install without internet access when your vendor's plan includes air-gapped bundles. Log in to your own registry with helm registry login if it needs credentials.
Older releases
Releases published before this feature don't record which images are charts, so they show no Helm section. The helm install command from Helm Charts and OCI Artifacts works for them.