1. Documentation
×

Installing Helm

Install the Helm CLI to manage software packages on your OKD cluster from a local workstation.

The Helm v4 CLI is now the current version of the Helm CLI for OKD. You can still use the Helm v3 CLI in OKD 5.0, but it is not available in OKD 5.1 and later. For information about moving from Helm v3 to Helm v4, see "Helm CLI for Red Hat OpenShift compatibility matrix."

The Helm v3 CLI is a deprecated feature. Deprecated functionality is still included in OKD and continues to be supported; however, it will be removed in a future release of this product and is not recommended for new deployments.

For the most recent list of major functionality that has been deprecated or removed within OKD, refer to the Deprecated and removed features section of the OKD release notes.

You can find the URL to the latest binaries in the OKD web console by clicking the help icon (?) and selecting Command Line Tools.

Replace <version> in the curl commands with the Helm version that matches your OKD cluster version. For more information, see "Helm CLI for Red Hat OpenShift compatibility matrix."

On Linux

  1. Download the Helm binary:

    • Linux (x86_64, amd64)

      # curl -L https://mirror.openshift.com/pub/cgw/helm/<version>/helm-linux-amd64 -o /usr/local/bin/helm

    • Linux on IBM Z® and IBM® LinuxONE (s390x)

      # curl -L https://mirror.openshift.com/pub/cgw/helm/<version>/helm-linux-s390x -o /usr/local/bin/helm

    • Linux on IBM Power® (ppc64le)

      # curl -L https://mirror.openshift.com/pub/cgw/helm/<version>/helm-linux-ppc64le -o /usr/local/bin/helm

    • Linux on ARM (arm64)

      # curl -L https://mirror.openshift.com/pub/cgw/helm/<version>/helm-linux-arm64 -o /usr/local/bin/helm

  2. Make the binary file executable:

    # chmod +x /usr/local/bin/helm

  3. Check the installed version:

    $ helm version
    Example output
    version.BuildInfo{Version:"v3.0", GitCommit:"b31719aab7963acf4887a1c1e6d5e53378e34d93", GitTreeState:"clean", GoVersion:"go1.13.4"}

On Windows

  1. Go to https://mirror.openshift.com/pub/cgw/helm/, open the folder for your Helm version, and download helm-windows-amd64.exe.

  2. Click Search and type env or environment.

  3. Select Edit environment variables for your account.

  4. Select Path from the Variable section and click Edit.

  5. Click New and type the path to the directory with the exe file into the field or click Browse and select the directory, and click OK.

On macOS

  1. Download the Helm binary:

    • For macOS on Intel (x86_64):

      # curl -L https://mirror.openshift.com/pub/cgw/helm/<version>/helm-darwin-amd64 -o /usr/local/bin/helm

    • For macOS on ARM (Apple Silicon):

      # curl -L https://mirror.openshift.com/pub/cgw/helm/<version>/helm-darwin-arm64 -o /usr/local/bin/helm

  2. Make the binary file executable:

    # chmod +x /usr/local/bin/helm

  3. Check the installed version:

    $ helm version
    Example output
    version.BuildInfo{Version:"v3.0", GitCommit:"b31719aab7963acf4887a1c1e6d5e53378e34d93", GitTreeState:"clean", GoVersion:"go1.13.4"}

Additional resources