You are looking at the documentation of a prior release. To read the documentation of the latest release, please
visit here.
Install in OpenShift
There are two ways to deploy KubeStash in OpenShift. Use Option A for the standard upstream chart, or Option B if you require the Red Hat OpenShift certified chart (for example, to satisfy a Red Hat OpenShift certification requirement).
Option A: Standard chart with OpenShift values
Use the standard kubestash chart and enable the OpenShift distribution values. This switches the operator to UBI-based images and applies the SecurityContextConstraints and other OpenShift-specific tweaks:
$ helm install kubestash oci://ghcr.io/appscode-charts/kubestash \
--version v2026.5.18-rc.0 \
--namespace stash --create-namespace \
--set-file global.license=/path/to/the/license.txt \
--set global.distro.openshift=true \
--set global.distro.ubi=all \
--wait --burst-limit=10000 --debug
Equivalently, in a values.yaml:
global:
distro:
openshift: true
ubi: "all"
global.distro.openshift: trueenables OpenShift-specific resources (SCCs, etc.).global.distro.ubi: "all"switches every component to UBI-based images. Set it tooperatorto only switch the operator images.
Option B: Red Hat OpenShift certified chart
The kubestash-certified chart is the Red Hat certified distribution of KubeStash. Unlike the standard chart, it does not include CRDs — the certification process requires CRDs to ship as a separate chart. You must therefore install the CRDs chart first, and then the operator chart.
Step 1: Install the CRDs
$ helm install kubestash-certified-crds oci://ghcr.io/appscode-charts/kubestash-certified-crds \
--version v2026.5.18-rc.0 \
--namespace stash --create-namespace \
--wait --burst-limit=10000 --debug
Step 2: Install the certified operator chart
$ helm install kubestash oci://ghcr.io/appscode-charts/kubestash-certified \
--version v2026.5.18-rc.0 \
--namespace stash \
--set-file global.license=/path/to/the/license.txt \
--wait --burst-limit=10000 --debug
Once installed, follow the Common Configuration steps to verify the operator and Addon catalogs are running.