Helm values

Commonly overridden values for the Klustre CSI Helm chart.

The chart is published as oci://ghcr.io/klustrefs/charts/klustre-csi-plugin. Run helm show values oci://ghcr.io/klustrefs/charts/klustre-csi-plugin --version 0.1.1 for the full schema. This page summarizes frequently tuned fields.

PathDefaultPurpose
image.repositoryghcr.io/klustrefs/klustre-csi-pluginNode plugin image repository.
image.tag0.1.1Node plugin tag.
imagePullSecrets[]Global image pull secrets applied to all pods.
nodePlugin.pluginDir/var/lib/kubelet/plugins/lustre.csi.klustrefs.ioHost path for CSI sockets.
nodePlugin.kubeletRegistrationPath/var/lib/kubelet/plugins/lustre.csi.klustrefs.io/csi.sockPath passed to kubelet registrar.
nodePlugin.logLevelinfoVerbosity for the node binary.
nodePlugin.resourcesrequests: 50m/50Mi, limits: 200m/200MiContainer resource settings.
nodePlugin.registrar.image.repositoryregistry.k8s.io/sig-storage/csi-node-driver-registrarSidecar repository.
nodePlugin.registrar.image.tagv2.10.1Sidecar tag.
nodePlugin.extraVolumes / extraVolumeMounts[]Inject custom host paths (e.g., additional libraries).
storageClass.createtrueToggle creation of klustre-csi-static.
storageClass.allowedTopologies[0].matchLabelExpressions[0].keylustre.csi.klustrefs.io/lustre-clientNode label key for placement.
storageClass.mountOptions["flock","user_xattr"]Default Lustre mount flags.
settingsConfigMap.createtrueControls whether the chart provisions klustre-csi-settings.
serviceAccount.createtrueCreate the node service account automatically.
rbac.createtrueProvision RBAC resources (ClusterRole/Binding).

Example override file

image:
  tag: 0.1.2
nodePlugin:
  logLevel: debug
  extraVolumeMounts:
    - name: host-etc
      mountPath: /host/etc
  extraVolumes:
    - name: host-etc
      hostPath:
        path: /etc
storageClass:
  mountOptions:
    - flock
    - user_xattr
    - noatime

Install with:

helm upgrade --install klustre-csi \
  oci://ghcr.io/klustrefs/charts/klustre-csi-plugin \
  --version 0.1.1 \
  --namespace klustre-system \
  --create-namespace \
  -f overrides.yaml

Last modified November 30, 2025: docs: restructure docs, disable blog (62b401e)