This is a cache of https://docs.okd.io/latest/applications/working_with_helm_charts/odc-working-with-helm-releases.html. It is a snapshot of the page at 2026-10-24T18:58:11.166+0000.
Working with <strong>helm</strong> releases - Working with <strong>helm</strong> charts | Building applications | OKD 5
  1. Documentation
×

Working with helm releases

You can use the web console to create, update, roll back, or delete a helm release.

Installing a helm release from a URL

A helm release is a deployed instance of a helm chart within your OKD cluster. You can install charts from the Software Catalog or by using a direct chart URL. Using a direct URL avoids the need for a configured helm repository. However, this method circumvents the validation that the Software Catalog provides. Use the direct URL method only when a chart is not available from the Software Catalog or configured repositories.

Install charts only from URLs you trust, because unverified charts can introduce security risks to your cluster. When possible, use charts from the Software Catalog or a configured helm repository instead.
Prerequisites

  • You’ve logged in to the OKD web console.

  • You have the necessary project permissions to install a helm chart.

  • You have a URL for a helm chart.

Procedure

  1. In the OKD web console, select Ecosystem > helm from the navigation menu. The helm view opens.

  2. In the Project drop-down menu, select the project where you want to install the helm release; for example, default.

  3. From the helm Releases tab, click Create.

  4. Select helm chart URL. The Install helm chart from URL view opens.

  5. In the Chart URL field, enter the URL for the helm chart you want to install.

    For helm charts stored in an OCI-compliant registry, the URL must use the oci:// protocol; for example, oci://quay.io/organization/repository/chart-name.

  6. In the Release name field, enter a name for the helm release you want to install.

  7. In the Chart version field, enter the chart version number if it is not detected automatically.

  8. Click Next. The Configure helm release view opens.

    • Review the configuration. Make sure that Chart URL, Release name, and Chart version are correct.

  9. For the Configure via option, select either Form view or YAML view.

    • Choose Form view (the default) for a guided configuration of standard parameters.

    • Choose YAML view if you need to change advanced settings that are not available in Form view.

      The Form view might not display every field from your helm chart. For full control over all configuration parameters, select YAML view.

  10. Click Install. The helm Releases tab opens and displays a status of Deployed if the installation succeeds.

Verification

  • The helm Releases tab displays the new helm release in the table.

  • The Status column for the helm release displays Deployed.

Additional resources

Upgrading a helm release

You can upgrade a helm release to use a new chart version or update your release configuration.

Procedure

  1. Navigate to Ecosystem → helm.

  2. Click the overflow menu in the release’s row and select Upgrade helm Release.

  3. On the Upgrade helm Release page, select the chart version you want if available, edit the values as needed, then click Upgrade to create a revision of the helm release. The Ecosystem → helm page shows the updated revision count.

Roll back a helm release

If upgrading a release fails, you can roll back the helm release to an earlier version.

Procedure

  1. Navigate to Ecosystem → helm.

  2. Click the overflow menu in the release’s row and select Rollback.

  3. On the Rollback helm Release page, select the Revision you want to roll back to and click Rollback.

  4. On the Ecosystem → helm page, click the chart to see the details and resources for that release.

  5. Go to the Revision History tab to see all the revisions for the chart.

  6. Optional: Click the overflow menu next to a revision and select the revision to roll back to.

Deleting a helm release

You can delete a helm release that you no longer need.

Procedure

  1. Navigate to Ecosystem → helm.

  2. Click the overflow menu in the release’s row and select Delete helm Release.

  3. In the confirmation prompt, enter the name of the release and click Delete.

Additional resources