Skip to content
Zarf

longhorn

This example shows you how to deploy Longhorn using Zarf.

Before deploying Longhorn, make sure your nodes are configured with the Longhorn Installation Requirements. Note that the automated longhornctl preflight environment checker is not included in this package to support multi-architecture compatibility, so node readiness must be verified manually.

You will need open-iscsi installed.

If you wish to support RWX access modes you’ll need to install an NFSv4 client on each node.

If you’re working with K3s, there is extra setup required. See Longhorn CSI on K3s.

The values file from this example was pulled using the directions at Customizing Default Settings as the path for kubelet needs to be set for K3s as per Longhorn CSI on K3s

You do not need to use the values file and can remove it from the Zarf package configuration if you’re not using K3s and don’t need that variable set.

zarf.yaml

kind: ZarfPackageConfig
metadata:
  name: longhorn
  description: Example package for Longhorn cloud native distributed block storage for Kubernetes
  version: 1.11.2
components:
  - name: longhorn
    required: true
    description: Deploy Longhorn into a Kubernetes cluster.  https://longhorn.io
    actions:
      # Set the delete confirmation flag for Longhorn
      onRemove:
        before:
          - cmd: './zarf tools kubectl -n longhorn-system patch -p ''{"value": "true"}'' --type=merge lhs deleting-confirmation-flag'
    manifests:
      - name: longhorn-connect
        namespace: longhorn-system
        files:
          - connect.yaml
    charts:
      - name: longhorn
        url: https://charts.longhorn.io
        version: 1.11.2
        namespace: longhorn-system
        valuesFiles:
          - values.yaml
    images:
      - longhornio/csi-attacher:v4.11.0-20260428
      - longhornio/csi-provisioner:v5.3.0-20260428
      - longhornio/csi-resizer:v2.1.0-20260428
      - longhornio/csi-snapshotter:v8.5.0-20260428
      - longhornio/csi-node-driver-registrar:v2.16.0-20260428
      - longhornio/livenessprobe:v2.18.0-20260428
      - longhornio/backing-image-manager:v1.11.2
      - longhornio/longhorn-engine:v1.11.2
      - longhornio/longhorn-instance-manager:v1.11.2
      - longhornio/longhorn-manager:v1.11.2
      - longhornio/longhorn-share-manager:v1.11.2
      - longhornio/longhorn-ui:v1.11.2
      - longhornio/support-bundle-kit:v0.0.84


documentation:
  readme: readme.md