longhorn
Helm chart
Request a free trial
Contact our team to test out this Helm chart and related images for free. Please also indicate any other images you would like to evaluate.
Tag:
1
# Default values for longhorn.
2
# This is a YAML-formatted file.
3
# Declare variables to be passed into your templates.
4
global:
5
# -- Global override for container image registry.
6
imageRegistry: "docker.io"
7
# -- Global override for image pull secrets for container registry.
8
imagePullSecrets: []
9
# -- Set container timezone (TZ env) for all Longhorn workloads. Leave empty to use container default.
10
timezone: ""
11
# -- Toleration for nodes allowed to run user-deployed components such as Longhorn Manager, Longhorn UI, and Longhorn Driver Deployer.
12
tolerations: []
13
# -- Node selector for nodes allowed to run user-deployed components such as Longhorn Manager, Longhorn UI, and Longhorn Driver Deployer.
14
nodeSelector: {}
15
cattle:
16
# -- Default system registry.
17
systemDefaultRegistry: ""
18
windowsCluster:
19
# -- Setting that allows Longhorn to run on a Rancher Windows cluster.
20
enabled: false
21
# -- Toleration for Linux nodes that can run user-deployed Longhorn components.
22
tolerations:
23
- key: "cattle.io/os"
24
value: "linux"
25
effect: "NoSchedule"
26
operator: "Equal"
27
# -- Node selector for Linux nodes that can run user-deployed Longhorn components.
28
nodeSelector:
29
kubernetes.io/os: "linux"
30
defaultSetting:
31
# -- Toleration for system-managed Longhorn components.
32
taintToleration: cattle.io/os=linux:NoSchedule
33
# -- Node selector for system-managed Longhorn components.
34
systemManagedComponentsNodeSelector: kubernetes.io/os:linux
35
networkPolicies:
36
# -- Setting that allows you to enable network policies that control access to Longhorn pods.
37
enabled: false
38
# -- Distribution that determines the policy for allowing access for an ingress. (Options: "k3s", "rke2", "rke1")
39
type: "k3s"
40
image:
41
longhorn:
42
engine:
43
# -- Registry for the Longhorn Engine image.
44
registry: chainreg.biz
45
# -- Repository for the Longhorn Engine image.
46
repository: chainguard-private/longhorn-engine
47
# -- Tag for the Longhorn Engine image.
48
tag: latest@sha256:1f4b81e31e7797b80939b99d84b85ca206cad0b23bc4c2af8c94a95ed2a8de51
49
manager:
50
# -- Registry for the Longhorn Manager image.
51
registry: chainreg.biz
52
# -- Repository for the Longhorn Manager image.
53
repository: chainguard-private/longhorn-manager
54
# -- Tag for the Longhorn Manager image.
55
tag: latest@sha256:3e0502e42a8c285a06a28f882050b64ae181f7cf7635a9cacf70d69ff8e335f0
56
ui:
57
# -- Registry for the Longhorn UI image.
58
registry: chainreg.biz
59
# -- Repository for the Longhorn UI image.
60
repository: chainguard-private/longhorn-ui
61
# -- Tag for the Longhorn UI image.
62
tag: latest@sha256:79aa0f1a80998666b68dc01720bfac4c6a9c7060e490ac13c2850bedc27e7d5c
63
instanceManager:
64
# -- Registry for the Longhorn Instance Manager image.
65
registry: chainreg.biz
66
# -- Repository for the Longhorn Instance Manager image.
67
repository: chainguard-private/longhorn-instance-manager
68
# -- Tag for the Longhorn Instance Manager image.
69
tag: latest@sha256:950f652b890f79138b12917a39aab3c13946ebe5906671dde7211bfad8bb04da
70
shareManager:
71
# -- Registry for the Longhorn Share Manager image.
72
registry: chainreg.biz
73
# -- Repository for the Longhorn Share Manager image.
74
repository: chainguard-private/longhorn-share-manager
75
# -- Tag for the Longhorn Share Manager image.
76
tag: latest@sha256:09995f57024611beec4e706b9f3d7cabde541739383c505bb28a9b596a2b8411
77
backingImageManager:
78
# -- Registry for the Backing Image Manager image. When unspecified, Longhorn uses the default value.
79
registry: chainreg.biz
80
# -- Repository for the Backing Image Manager image. When unspecified, Longhorn uses the default value.
81
repository: chainguard-private/backing-image-manager
82
# -- Tag for the Backing Image Manager image. When unspecified, Longhorn uses the default value.
83
tag: latest@sha256:517d6323cc7f70400ad16e4b5640a74bdbdf3d2e9acade28a2a8a9d916362a8a
84
supportBundleKit:
85
# -- Registry for the Longhorn Support Bundle Manager image.
86
registry: chainreg.biz
87
# -- Repository for the Longhorn Support Bundle Manager image.
88
repository: chainguard-private/longhorn-support-bundle-kit
89
# -- Tag for the Longhorn Support Bundle Manager image.
90
tag: latest@sha256:50f27b336acb72c27ef60b98fc23ac673dd3c89eb1c779752e9de8e29232d5c7
91
csi:
92
attacher:
93
# -- Registry for the CSI attacher image. When unspecified, Longhorn uses the default value.
94
registry: chainreg.biz
95
# -- Repository for the CSI attacher image. When unspecified, Longhorn uses the default value.
96
repository: chainguard-private/longhorn-csi-attacher
97
# -- Tag for the CSI attacher image. When unspecified, Longhorn uses the default value.
98
tag: latest@sha256:22f732996007f6de517d06befebf382c1e8e0592fd09bec00479ab1ad574e5aa
99
provisioner:
100
# -- Registry for the CSI Provisioner image. When unspecified, Longhorn uses the default value.
101
registry: chainreg.biz
102
# -- Repository for the CSI Provisioner image. When unspecified, Longhorn uses the default value.
103
repository: chainguard-private/longhorn-csi-provisioner
104
# -- Tag for the CSI Provisioner image. When unspecified, Longhorn uses the default value.
105
tag: latest@sha256:cd31674d24977a03a02e993382e6c7e1d7cb8a115d39e74ccaa0d6c462097895
106
nodeDriverRegistrar:
107
# -- Registry for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value.
108
registry: chainreg.biz
109
# -- Repository for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value.
110
repository: chainguard-private/longhorn-csi-node-driver-registrar
111
# -- Tag for the CSI Node Driver Registrar image. When unspecified, Longhorn uses the default value.
112
tag: latest@sha256:90071e609042a0a0486e3a76ff9bdc9094ecb663a7e84d8abafc6c13b4344001
113
resizer:
114
# -- Registry for the CSI Resizer image. When unspecified, Longhorn uses the default value.
115
registry: chainreg.biz
116
# -- Repository for the CSI Resizer image. When unspecified, Longhorn uses the default value.
117
repository: chainguard-private/longhorn-csi-resizer
118
# -- Tag for the CSI Resizer image. When unspecified, Longhorn uses the default value.
119
tag: latest@sha256:8eb3d5bf3c34685b1664daac442537a318785af9cc0056b505ed6fd1b871fc7a
120
snapshotter:
121
# -- Registry for the CSI Snapshotter image. When unspecified, Longhorn uses the default value.
122
registry: chainreg.biz
123
# -- Repository for the CSI Snapshotter image. When unspecified, Longhorn uses the default value.
124
repository: chainguard-private/longhorn-csi-snapshotter
125
# -- Tag for the CSI Snapshotter image. When unspecified, Longhorn uses the default value.
126
tag: latest@sha256:b22f5252d9aeaa65a5bc916db3da025d315ba64b7c77bab70ad613c62afec985
127
livenessProbe:
128
# -- Registry for the CSI liveness probe image. When unspecified, Longhorn uses the default value.
129
registry: chainreg.biz
130
# -- Repository for the CSI liveness probe image. When unspecified, Longhorn uses the default value.
131
repository: chainguard-private/longhorn-livenessprobe
132
# -- Tag for the CSI liveness probe image. When unspecified, Longhorn uses the default value.
133
tag: latest@sha256:5ea5dc90800a02c480af4afeba493ba03fcd2d5ef992c1568a0d4a2212e7b0a8
134
openshift:
135
oauthProxy:
136
# -- Registry for the OAuth Proxy image. Specify the upstream image (for example, "quay.io/openshift/origin-oauth-proxy"). This setting applies only to OpenShift users.
137
registry: ""
138
# -- Repository for the OAuth Proxy image. Specify the upstream image (for example, "quay.io/openshift/origin-oauth-proxy"). This setting applies only to OpenShift users.
139
repository: ""
140
# -- Tag for the OAuth Proxy image. Specify OCP/OKD version 4.1 or later (including version 4.18, which is available at quay.io/openshift/origin-oauth-proxy:4.18). This setting applies only to OpenShift users.
141
tag: ""
142
# -- Image pull policy that applies to all user-deployed Longhorn components, such as Longhorn Manager, Longhorn driver, and Longhorn UI.
143
pullPolicy: IfNotPresent
144
service:
145
ui:
146
# -- Service type for Longhorn UI. (Options: "ClusterIP", "NodePort", "LoadBalancer", "Rancher-Proxy")
147
type: ClusterIP
148
# -- NodePort port number for Longhorn UI. When unspecified, Longhorn selects a free port between 30000 and 32767.
149
nodePort: null
150
# -- Class of a load balancer implementation
151
loadBalancerClass: ""
152
# -- Annotation for the Longhorn UI service.
153
annotations: {}
154
## If you want to set annotations for the Longhorn UI service, delete the `{}` in the line above
155
## and uncomment this example block
156
# annotation-key1: "annotation-value1"
157
# annotation-key2: "annotation-value2"
158
labels: {}
159
## If you want to set additional labels for the Longhorn UI service, delete the `{}` in the line above
160
## and uncomment this example block
161
# label-key1: "label-value1"
162
# label-key2: "label-value2"
163
manager:
164
# -- Service type for Longhorn Manager.
165
type: ClusterIP
166
# -- NodePort port number for Longhorn Manager. When unspecified, Longhorn selects a free port between 30000 and 32767.
167
nodePort: ""
168
persistence:
169
# -- Setting that allows you to specify the default Longhorn StorageClass.
170
defaultClass: true
171
# -- Filesystem type of the default Longhorn StorageClass.
172
defaultFsType: ext4
173
# -- mkfs parameters of the default Longhorn StorageClass.
174
defaultMkfsParams: ""
175
# -- Replica count of the default Longhorn StorageClass.
176
defaultClassReplicaCount: 3
177
# -- Data locality of the default Longhorn StorageClass. (Options: "disabled", "best-effort")
178
defaultDataLocality: disabled
179
# -- Reclaim policy that provides instructions for handling of a volume after its claim is released. (Options: "Retain", "Delete")
180
reclaimPolicy: Delete
181
# -- VolumeBindingMode controls when volume binding and dynamic provisioning should occur. (Options: "Immediate", "WaitForFirstConsumer") (Defaults to "Immediate")
182
volumeBindingMode: "Immediate"
183
# -- Setting that allows you to enable live migration of a Longhorn volume from one node to another.
184
migratable: false
185
# -- Setting that disables the revision counter and thereby prevents Longhorn from tracking all write operations to a volume. When salvaging a volume, Longhorn uses properties of the volume-head-xxx.img file (the last file size and the last time the file was modified) to select the replica to be used for volume recovery.
186
disableRevisionCounter: "true"
187
# -- Set NFS mount options for Longhorn StorageClass for RWX volumes
188
nfsOptions: ""
189
recurringJobSelector:
190
# -- Setting that allows you to enable the recurring job selector for a Longhorn StorageClass.
191
enable: false
192
# -- Recurring job selector for a Longhorn StorageClass. Ensure that quotes are used correctly when specifying job parameters. (Example: `[{"name":"backup", "isGroup":true}]`)
193
jobList: []
194
backingImage:
195
# -- Setting that allows you to use a backing image in a Longhorn StorageClass.
196
enable: false
197
# -- Backing image to be used for creating and restoring volumes in a Longhorn StorageClass. When no backing images are available, specify the data source type and parameters that Longhorn can use to create a backing image.
198
name: ~
199
# -- Data source type of a backing image used in a Longhorn StorageClass.
200
# If the backing image exists in the cluster, Longhorn uses this setting to verify the image.
201
# If the backing image does not exist, Longhorn creates one using the specified data source type.
202
dataSourceType: ~
203
# -- Data source parameters of a backing image used in a Longhorn StorageClass.
204
# You can specify a JSON string of a map. (Example: `'{\"url\":\"https://backing-image-example.s3-region.amazonaws.com/test-backing-image\"}'`)
205
dataSourceParameters: ~
206
# -- Expected SHA-512 checksum of a backing image used in a Longhorn StorageClass.
207
expectedChecksum: ~
208
defaultDiskSelector:
209
# -- Setting that allows you to enable the disk selector for the default Longhorn StorageClass.
210
enable: false
211
# -- Disk selector for the default Longhorn StorageClass. Longhorn uses only disks with the specified tags for storing volume data. (Examples: "nvme,sata")
212
selector: ""
213
defaultNodeSelector:
214
# -- Setting that allows you to enable the node selector for the default Longhorn StorageClass.
215
enable: false
216
# -- Node selector for the default Longhorn StorageClass. Longhorn uses only nodes with the specified tags for storing volume data. (Examples: "storage,fast")
217
selector: ""
218
# -- Setting that allows you to enable automatic snapshot removal during filesystem trim for a Longhorn StorageClass. (Options: "ignored", "enabled", "disabled")
219
unmapMarkSnapChainRemoved: ignored
220
# -- Setting that allows you to specify the data engine version for the default Longhorn StorageClass. (Options: "v1", "v2")
221
dataEngine: v1
222
# -- Setting that allows you to specify the backup target for the default Longhorn StorageClass.
223
backupTargetName: default
224
preUpgradeChecker:
225
# -- Setting that allows Longhorn to perform pre-upgrade checks. Disable this setting when installing Longhorn using Argo CD or other GitOps solutions.
226
jobEnabled: true
227
# -- Setting that allows Longhorn to perform upgrade version checks after starting the Longhorn Manager DaemonSet Pods. Disabling this setting also disables `preUpgradeChecker.jobEnabled`. Longhorn recommends keeping this setting enabled.
228
upgradeVersionCheck: true
229
csi:
230
# -- kubelet root directory. When unspecified, Longhorn uses the default value.
231
kubeletRootDir: ~
232
# -- Configures Pod anti-affinity to prevent multiple instances on the same node. Use soft (tries to separate) or hard (must separate). When unspecified, Longhorn uses the default value ("soft").
233
podAntiAffinityPreset: ~
234
# -- Replica count of the CSI Attacher. When unspecified, Longhorn uses the default value ("3").
235
attacherReplicaCount: ~
236
# -- Replica count of the CSI Provisioner. When unspecified, Longhorn uses the default value ("3").
237
provisionerReplicaCount: ~
238
# -- Replica count of the CSI Resizer. When unspecified, Longhorn uses the default value ("3").
239
resizerReplicaCount: ~
240
# -- Replica count of the CSI Snapshotter. When unspecified, Longhorn uses the default value ("3").
241
snapshotterReplicaCount: ~
242
defaultSettings:
243
# -- Setting that allows Longhorn to automatically attach a volume and create snapshots or backups when recurring jobs are run.
244
allowRecurringJobWhileVolumeDetached: ~
245
# -- Setting that allows Longhorn to automatically create a default disk only on nodes with the label "node.longhorn.io/create-default-disk=true" (if no other disks exist). When this setting is disabled, Longhorn creates a default disk on each node that is added to the cluster.
246
createDefaultDiskLabeledNodes: ~
247
# -- Default path to use for storing data on a host. An absolute directory path indicates a filesystem-type disk used by the V1 Data Engine, while a path to a block device indicates a block-type disk used by the V2 Data Engine. The default value is "/var/lib/longhorn/".
248
defaultDataPath: ~
249
# -- Default data locality. A Longhorn volume has data locality if a local replica of the volume exists on the same node as the pod that is using the volume.
250
defaultDataLocality: ~
251
# -- Setting that allows scheduling on nodes with healthy replicas of the same volume. This setting is disabled by default.
252
replicaSoftAntiAffinity: ~
253
# -- Setting that automatically rebalances replicas when an available node is discovered.
254
replicaAutoBalance: ~
255
# -- Percentage of storage that can be allocated relative to hard drive capacity. The default value is "100".
256
storageOverProvisioningPercentage: ~
257
# -- Percentage of minimum available disk capacity. When the minimum available capacity exceeds the total available capacity, the disk becomes unschedulable until more space is made available for use. The default value is "25".
258
storageMinimalAvailablePercentage: ~
259
# -- Percentage of disk space that is not allocated to the default disk on each new Longhorn node.
260
storageReservedPercentageForDefaultDisk: ~
261
# -- Upgrade Checker that periodically checks for new Longhorn versions. When a new version is available, a notification appears on the Longhorn UI. This setting is enabled by default
262
upgradeChecker: ~
263
# -- The Upgrade Responder sends a notification whenever a new Longhorn version that you can upgrade to becomes available. The default value is https://longhorn-upgrade-responder.rancher.io/v1/checkupgrade.
264
upgradeResponderURL: ~
265
# -- URL prefix embedded in Longhorn Manager API response links (the "actions" and "links" fields). When set, internal components such as longhorn-driver-deployer and longhorn-csi-plugin will follow links using this URL, so it must be reachable from within the cluster without authentication. Setting this to an externally-facing URL that is protected by auth middleware (e.g. OAuth2 proxy, ingress auth) will cause internal components to receive an HTML redirect instead of JSON, resulting in "invalid character '<'" errors and CSI driver deployment failure. Use this setting only when the URL is accessible unauthenticated from inside the cluster. Format: scheme://host[:port] (for example, http://longhorn.example.com). Leave empty to use the default behavior (internal pod IP). Note: this value is persisted in the manager-url Setting CR; removing it from Helm values does not automatically clear the CR. To reset, manually set the manager-url Setting CR value to empty via the Longhorn UI or kubectl.
266
managerUrl: ~
267
# -- Default number of replicas for volumes created using the Longhorn UI. For Kubernetes configuration, modify the `numberOfReplicas` field in the StorageClass. The default value is "{"v1":"3","v2":"3"}".
268
defaultReplicaCount: ~
269
# -- Default name of Longhorn static StorageClass. "storageClassName" is assigned to PVs and PVCs that are created for an existing Longhorn volume. "storageClassName" can also be used as a label, so it is possible to use a Longhorn StorageClass to bind a workload to an existing PV without creating a Kubernetes StorageClass object. "storageClassName" needs to be an existing StorageClass. The default value is "longhorn-static".
270
defaultLonghornStaticStorageClass: ~
271
# -- Number of minutes that Longhorn keeps a failed backup resource. When the value is "0", automatic deletion is disabled.
272
failedBackupTTL: ~
273
# -- Number of minutes that Longhorn allows for the backup execution. The default value is "1".
274
backupExecutionTimeout: ~
275
# -- Setting that restores recurring jobs from a backup volume on a backup target and creates recurring jobs if none exist during backup restoration.
276
restoreVolumeRecurringJobs: ~
277
# -- Maximum number of successful recurring backup and snapshot jobs to be retained. When the value is "0", a history of successful recurring jobs is not retained.
278
recurringSuccessfulJobsHistoryLimit: ~
279
# -- Maximum number of failed recurring backup and snapshot jobs to be retained. When the value is "0", a history of failed recurring jobs is not retained.
280
recurringFailedJobsHistoryLimit: ~
281
# -- Maximum number of snapshots or backups to be retained.
282
recurringJobMaxRetention: ~
283
# -- Maximum number of failed support bundles that can exist in the cluster. When the value is "0", Longhorn automatically purges all failed support bundles.
284
supportBundleFailedHistoryLimit: ~
285
# -- Taint or toleration for system-managed Longhorn components.
286
# Specify values using a semicolon-separated list in `kubectl taint` syntax (Example: key1=value1:effect; key2=value2:effect).
287
taintToleration: ~
288
# -- Node selector for system-managed Longhorn components.
289
systemManagedComponentsNodeSelector: ~
290
# -- Resource limits for system-managed CSI components.
291
# This setting allows you to configure CPU and memory requests/limits for CSI attacher, provisioner, resizer, snapshotter, and plugin components.
292
# Supported components: csi-attacher, csi-provisioner, csi-resizer, csi-snapshotter, longhorn-csi-plugin, node-driver-registrar, longhorn-liveness-probe.
293
# Notice that changing resource limits will cause CSI components to restart, which may temporarily affect volume provisioning and attach/detach operations until the components are ready. The value should be a JSON object with component names as keys and ResourceRequirements as values.
294
systemManagedCSIComponentsResourceLimits: ~
295
# -- PriorityClass for system-managed Longhorn components.
296
# This setting can help prevent Longhorn components from being evicted under Node Pressure.
297
# Notice that this will be applied to Longhorn user-deployed components by default if there are no priority class values set yet, such as `longhornManager.priorityClass`.
298
priorityClass: &defaultPriorityClassNameRef "longhorn-critical"
299
# -- Setting that allows Longhorn to automatically salvage volumes when all replicas become faulty (for example, when the network connection is interrupted). Longhorn determines which replicas are usable and then uses these replicas for the volume. This setting is enabled by default.
300
autoSalvage: ~
301
# -- Setting that allows Longhorn to automatically delete a workload pod that is managed by a controller (for example, daemonset) whenever a Longhorn volume is detached unexpectedly (for example, during Kubernetes upgrades). After deletion, the controller restarts the pod and then Kubernetes handles volume reattachment and remounting.
302
autoDeletePodWhenVolumeDetachedUnexpectedly: ~
303
# -- Blacklist of controller api/kind values for the setting Automatically Delete Workload Pod when the Volume Is Detached Unexpectedly. If a workload pod is managed by a controller whose api/kind is listed in this blacklist, Longhorn will not automatically delete the pod when its volume is unexpectedly detached. Multiple controller api/kind entries can be specified, separated by semicolons. For example: `apps/StatefulSet;apps/DaemonSet`. Note that the controller api/kind is case sensitive and must exactly match the api/kind in the workload pod's owner reference.
304
blacklistForAutoDeletePodWhenVolumeDetachedUnexpectedly: ~
305
# -- Setting that prevents Longhorn Manager from scheduling replicas on a cordoned Kubernetes node. This setting is enabled by default.
306
disableSchedulingOnCordonedNode: ~
307
# -- Setting that allows Longhorn to schedule new replicas of a volume to nodes in the same zone as existing healthy replicas. Nodes that do not belong to any zone are treated as existing in the zone that contains healthy replicas. When identifying zones, Longhorn relies on the label "topology.kubernetes.io/zone=<Zone name of the node>" in the Kubernetes node object.
308
replicaZoneSoftAntiAffinity: ~
309
# -- Setting that allows scheduling on disks with existing healthy replicas of the same volume. This setting is enabled by default.
310
replicaDiskSoftAntiAffinity: ~
311
# -- Policy that defines the action Longhorn takes when a volume is stuck with a StatefulSet or Deployment pod on a node that failed.
312
nodeDownPodDeletionPolicy: ~
313
# -- Policy that defines the action Longhorn takes when a node with the last healthy replica of a volume is drained.
314
nodeDrainPolicy: ~
315
# -- Setting that allows automatic detaching of manually-attached volumes when a node is cordoned.
316
detachManuallyAttachedVolumesWhenCordoned: ~
317
# -- Number of seconds that Longhorn waits before reusing existing data on a failed replica instead of creating a new replica of a degraded volume.
318
replicaReplenishmentWaitInterval: ~
319
# -- Maximum number of replicas that can be concurrently rebuilt on each node.
320
concurrentReplicaRebuildPerNodeLimit: ~
321
# -- Maximum number of file synchronization operations that can run concurrently during a single replica rebuild. Right now, it's for v1 data engine only.
322
rebuildConcurrentSyncLimit: ~
323
# -- Maximum number of volumes that can be concurrently restored on each node using a backup. When the value is "0", restoration of volumes using a backup is disabled.
324
concurrentVolumeBackupRestorePerNodeLimit: ~
325
# -- Setting that disables the revision counter and thereby prevents Longhorn from tracking all write operations to a volume. When salvaging a volume, Longhorn uses properties of the "volume-head-xxx.img" file (the last file size and the last time the file was modified) to select the replica to be used for volume recovery. This setting applies only to volumes created using the Longhorn UI.
326
disableRevisionCounter: '{"v1":"true"}'
327
# -- Image pull policy for system-managed pods, such as Instance Manager, engine images, and CSI Driver. Changes to the image pull policy are applied only after the system-managed pods restart.
328
systemManagedPodsImagePullPolicy: ~
329
# -- Setting that allows you to create and attach a volume without having all replicas scheduled at the time of creation.
330
allowVolumeCreationWithDegradedAvailability: ~
331
# -- Setting that allows Longhorn to automatically clean up the system-generated snapshot after replica rebuilding is completed.
332
autoCleanupSystemGeneratedSnapshot: ~
333
# -- Setting that allows Longhorn to automatically clean up the snapshot generated by a recurring backup job.
334
autoCleanupRecurringJobBackupSnapshot: ~
335
# -- Maximum number of engines that are allowed to concurrently upgrade on each node after Longhorn Manager is upgraded. When the value is "0", Longhorn does not automatically upgrade volume engines to the new default engine image version.
336
concurrentAutomaticEngineUpgradePerNodeLimit: ~
337
# -- Number of minutes that Longhorn waits before cleaning up the backing image file when no replicas in the disk are using it.
338
backingImageCleanupWaitInterval: ~
339
# -- Number of seconds that Longhorn waits before downloading a backing image file again when the status of all image disk files changes to "failed" or "unknown".
340
backingImageRecoveryWaitInterval: ~
341
# -- Percentage of the total allocatable CPU resources on each node to be reserved for each instance manager pod. The default value is {"v1":"12","v2":"12"}.
342
guaranteedInstanceManagerCPU: ~
343
# -- Setting that notifies Longhorn that the cluster is using the Kubernetes Cluster Autoscaler.
344
kubernetesClusterAutoscalerEnabled: ~
345
# -- Enables Longhorn to automatically delete orphaned resources and their associated data or processes (e.g., stale replicas). Orphaned resources on failed or unknown nodes are not automatically cleaned up.
346
# You need to specify the resource types to be deleted using a semicolon-separated list (e.g., `replica-data;instance`). Available items are: `replica-data`, `instance`.
347
orphanResourceAutoDeletion: ~
348
# -- Specifies the wait time, in seconds, before Longhorn automatically deletes an orphaned Custom Resource (CR) and its associated resources.
349
# Note that if a user manually deletes an orphaned CR, the deletion occurs immediately and does not respect this grace period.
350
orphanResourceAutoDeletionGracePeriod: ~
351
# -- Storage network for in-cluster traffic. When unspecified, Longhorn uses the Kubernetes cluster network.
352
storageNetwork: ~
353
# -- Specifies a dedicated network for mounting RWX (ReadWriteMany) volumes. Leave this blank to use the default Kubernetes cluster network. **Caution**: This setting should change after all RWX volumes are detached because some Longhorn component pods must be recreated to apply the setting. You cannot modify this setting while RWX volumes are still attached.
354
endpointNetworkForRWXVolume: ~
355
# -- Flag that prevents accidental uninstallation of Longhorn.
356
deletingConfirmationFlag: ~
357
# -- Timeout between the Longhorn Engine and replicas. Specify a value between "8" and "30" seconds. The default value is "8".
358
engineReplicaTimeout: ~
359
# -- Setting that allows you to enable and disable snapshot hashing and data integrity checks.
360
snapshotDataIntegrity: ~
361
# -- Setting that allows disabling of snapshot hashing after snapshot creation to minimize impact on system performance.
362
snapshotDataIntegrityImmediateCheckAfterSnapshotCreation: ~
363
# -- Setting that defines when Longhorn checks the integrity of data in snapshot disk files. You must use the Unix cron expression format.
364
snapshotDataIntegrityCronjob: ~
365
# -- Setting that controls how many snapshot heavy task operations (such as purge and clone) can run concurrently per node. This is a best-effort mechanism: due to the distributed nature of the system, temporary oversubscription may occur. The limiter reduces worst-case overload but does not guarantee perfect enforcement.
366
snapshotHeavyTaskConcurrentLimit: ~
367
# -- Setting that allows Longhorn to automatically mark the latest snapshot and its parent files as removed during a filesystem trim. Longhorn does not remove snapshots containing multiple child files.
368
removeSnapshotsDuringFilesystemTrim: ~
369
# -- Setting that allows fast rebuilding of replicas using the checksum of snapshot disk files. Before enabling this setting, you must set the snapshot-data-integrity value to "enable" or "fast-check".
370
fastReplicaRebuildEnabled: ~
371
# -- Number of seconds that an HTTP client waits for a response from a File Sync server before considering the connection to have failed.
372
replicaFileSyncHttpClientTimeout: ~
373
# -- Number of seconds that Longhorn allows for the completion of replica rebuilding and snapshot cloning operations.
374
longGRPCTimeOut: ~
375
# -- Log levels that indicate the type and severity of logs in Longhorn Manager. The default value is "Info". (Options: "Panic", "Fatal", "Error", "Warn", "Info", "Debug", "Trace")
376
logLevel: ~
377
# -- Specifies the directory on the host where Longhorn stores log files for the instance manager pod. Currently, it is only used for instance manager pods in the v2 data engine.
378
logPath: ~
379
# -- Setting that allows you to specify a backup compression method.
380
backupCompressionMethod: ~
381
# -- Maximum number of worker threads that can concurrently run for each backup.
382
backupConcurrentLimit: ~
383
# -- Specifies the default backup block size, in MiB, used when creating a new volume. Supported values are 2 or 16.
384
defaultBackupBlockSize: ~
385
# -- Maximum number of worker threads that can concurrently run for each restore operation.
386
restoreConcurrentLimit: ~
387
# -- Setting that allows you to enable the V1 Data Engine.
388
v1DataEngine: ~
389
# -- Setting that allows you to enable the V2 Data Engine, which is based on the Storage Performance Development Kit (SPDK). The V2 Data Engine is an experimental feature and should not be used in production environments.
390
v2DataEngine: ~
391
# -- Applies only to the V2 Data Engine. Enables hugepages for the Storage Performance Development Kit (SPDK) target daemon. If disabled, legacy memory is used. Allocation size is set via the Data Engine Memory Size setting.
392
dataEngineHugepageEnabled: ~
393
# -- Applies only to the V2 Data Engine. Specifies the hugepage size, in MiB, for the Storage Performance Development Kit (SPDK) target daemon. The default value is "{"v2":"2048"}"
394
dataEngineMemorySize: ~
395
# -- Applies only to the V2 Data Engine. Specifies the CPU cores on which the Storage Performance Development Kit (SPDK) target daemon runs. The daemon is deployed in each Instance Manager pod. Ensure that the number of assigned cores does not exceed the guaranteed Instance Manager CPUs for the V2 Data Engine. The default value is "{"v2":"0x1"}".
396
dataEngineCPUMask: ~
397
# -- This setting specifies the default write bandwidth limit (in megabytes per second) for volume replica rebuilding when using the v2 data engine (SPDK). If this value is set to 0, there will be no write bandwidth limitation. Individual volumes can override this setting by specifying their own rebuilding bandwidth limit.
398
replicaRebuildingBandwidthLimit: ~
399
# -- This setting specifies the default depth of each queue for Ublk frontend. This setting applies to volumes using the V2 Data Engine with Ublk front end. Individual volumes can override this setting by specifying their own Ublk queue depth.
400
defaultUblkQueueDepth: ~
401
# -- This setting specifies the default the number of queues for ublk frontend. This setting applies to volumes using the V2 Data Engine with Ublk front end. Individual volumes can override this setting by specifying their own number of queues for ublk.
402
defaultUblkNumberOfQueue: ~
403
# -- In seconds. The setting specifies the timeout for the instance manager pod liveness probe. The default value is 10 seconds.
404
instanceManagerPodLivenessProbeTimeout: ~
405
# -- Setting that allows scheduling of empty node selector volumes to any node.
406
allowEmptyNodeSelectorVolume: ~
407
# -- Setting that allows scheduling of empty disk selector volumes to any disk.
408
allowEmptyDiskSelectorVolume: ~
409
# -- Setting that allows Longhorn to periodically collect anonymous usage data for product improvement purposes. Longhorn sends collected data to the [Upgrade Responder](https://github.com/longhorn/upgrade-responder) server, which is the data source of the Longhorn Public Metrics Dashboard (https://metrics.longhorn.io). The Upgrade Responder server does not store data that can be used to identify clients, including IP addresses.
410
allowCollectingLonghornUsageMetrics: ~
411
# -- Setting that temporarily prevents all attempts to purge volume snapshots.
412
disableSnapshotPurge: ~
413
# -- Maximum snapshot count for a volume. The value should be between 2 to 250
414
snapshotMaxCount: ~
415
# -- Applies only to the V2 Data Engine. Specifies the log level for the Storage Performance Development Kit (SPDK) target daemon. Supported values are: Error, Warning, Notice, Info, and Debug. The default is Notice.
416
dataEngineLogLevel: ~
417
# -- Applies only to the V2 Data Engine. Specifies the log flags for the Storage Performance Development Kit (SPDK) target daemon.
418
dataEngineLogFlags: ~
419
# -- Setting that freezes the filesystem on the root partition before a snapshot is created.
420
freezeFilesystemForSnapshot: ~
421
# -- Setting that automatically cleans up the snapshot when the backup is deleted.
422
autoCleanupSnapshotWhenDeleteBackup: ~
423
# -- Setting that automatically cleans up the snapshot after the on-demand backup is completed.
424
autoCleanupSnapshotAfterOnDemandBackupCompleted: ~
425
# -- Setting that allows Longhorn to detect node failure and immediately migrate affected RWX volumes.
426
rwxVolumeFastFailover: ~
427
# -- Enables automatic rebuilding of degraded replicas while the volume is detached. This setting only takes effect if the individual volume setting is set to `ignored` or `enabled`.
428
offlineReplicaRebuilding: ~
429
# -- Controls whether Longhorn monitors and records health information for node disks. When disabled, disk health checks and status updates are skipped.
430
nodeDiskHealthMonitoring: ~
431
# -- Comma-separated list of topology keys that the Longhorn CSI driver is allowed to pass through. When empty (default), no topology keys are passed through, and PVs will have no nodeAffinity. When configured (e.g., "topology.kubernetes.io/zone,topology.kubernetes.io/region"), only the specified keys are kept in topology segments. All other keys are filtered out from both CreateVolumeResponse.AccessibleTopology and NodeGetInfo topology.
432
csiAllowedTopologyKeys: ~
433
# -- Setting that controls CSI storage capacity tracking, which allows the kube-scheduler to filter nodes that cannot fit the requested volume.
434
csiStorageCapacityTracking: ~
435
# -- Setting that allows you to update the default backupstore.
436
defaultBackupStore:
437
# -- Endpoint used to access the default backupstore. (Options: "NFS", "CIFS", "AWS", "GCP", "AZURE")
438
backupTarget: ~
439
# -- Name of the Kubernetes secret associated with the default backup target.
440
backupTargetCredentialSecret: ~
441
# -- Number of seconds that Longhorn waits before checking the default backupstore for new backups. The default value is "300". When the value is "0", polling is disabled.
442
pollInterval: ~
443
privateRegistry:
444
# -- Set to `true` to automatically create a new private registry secret.
445
createSecret: ~
446
# -- URL of a private registry. When unspecified, Longhorn uses the default system registry.
447
registryUrl: ~
448
# -- User account used for authenticating with a private registry.
449
registryUser: ~
450
# -- Password for authenticating with a private registry.
451
registryPasswd: ~
452
# -- If create a new private registry secret is true, create a Kubernetes secret with this name; else use the existing secret of this name. Use it to pull images from your private registry.
453
registrySecret: ~
454
longhornManager:
455
log:
456
# -- Format of Longhorn Manager logs. (Options: "plain", "json")
457
format: plain
458
# -- PriorityClass for Longhorn Manager.
459
priorityClass: *defaultPriorityClassNameRef
460
# -- Toleration for Longhorn Manager on nodes allowed to run Longhorn components.
461
tolerations: []
462
## If you want to set tolerations for Longhorn Manager DaemonSet, delete the `[]` in the line above
463
## and uncomment this example block
464
# - key: "key"
465
# operator: "Equal"
466
# value: "value"
467
# effect: "NoSchedule"
468
# -- Resource requests and limits for Longhorn Manager pods.
469
resources: ~
470
# -- Node selector for Longhorn Manager. Specify the nodes allowed to run Longhorn Manager.
471
nodeSelector: {}
472
## If you want to set node selector for Longhorn Manager DaemonSet, delete the `{}` in the line above
473
## and uncomment this example block
474
# label-key1: "label-value1"
475
# label-key2: "label-value2"
476
# -- Annotation for the Longhorn Manager service.
477
serviceAnnotations: {}
478
## If you want to set annotations for the Longhorn Manager service, delete the `{}` in the line above
479
## and uncomment this example block
480
# annotation-key1: "annotation-value1"
481
# annotation-key2: "annotation-value2"
482
serviceLabels: {}
483
## If you want to set labels for the Longhorn Manager service, delete the `{}` in the line above
484
## and uncomment this example block
485
# label-key1: "label-value1"
486
# label-key2: "label-value2"
487
## DaemonSet update strategy. Default "100% unavailable" matches the upgrade
488
## flow (old managers removed before new start); override for rolling updates
489
## if you prefer that behavior.
490
updateStrategy:
491
rollingUpdate:
492
maxUnavailable: "100%"
493
longhornDriver:
494
log:
495
# -- Format of longhorn-driver logs. (Options: "plain", "json")
496
format: plain
497
# -- PriorityClass for Longhorn Driver.
498
priorityClass: *defaultPriorityClassNameRef
499
# -- Toleration for Longhorn Driver on nodes allowed to run Longhorn components.
500
tolerations: []
501
## If you want to set tolerations for Longhorn Driver Deployer Deployment, delete the `[]` in the line above
502
## and uncomment this example block
503
# - key: "key"
504
# operator: "Equal"
505
# value: "value"
506
# effect: "NoSchedule"
507
# -- Node selector for Longhorn Driver. Specify the nodes allowed to run Longhorn Driver.
508
nodeSelector: {}
509
## If you want to set node selector for Longhorn Driver Deployer Deployment, delete the `{}` in the line above
510
## and uncomment this example block
511
# label-key1: "label-value1"
512
# label-key2: "label-value2"
513
longhornUI:
514
# -- Replica count for Longhorn UI.
515
replicas: 2
516
# -- PriorityClass for Longhorn UI.
517
priorityClass: *defaultPriorityClassNameRef
518
# -- Affinity for Longhorn UI pods. Specify the affinity you want to use for Longhorn UI.
519
affinity:
520
podAntiAffinity:
521
preferredDuringSchedulingIgnoredDuringExecution:
522
- weight: 1
523
podAffinityTerm:
524
labelSelector:
525
matchExpressions:
526
- key: app
527
operator: In
528
values:
529
- longhorn-ui
530
topologyKey: kubernetes.io/hostname
531
# -- Toleration for Longhorn UI on nodes allowed to run Longhorn components.
532
tolerations: []
533
## If you want to set tolerations for Longhorn UI Deployment, delete the `[]` in the line above
534
## and uncomment this example block
535
# - key: "key"
536
# operator: "Equal"
537
# value: "value"
538
# effect: "NoSchedule"
539
# -- Node selector for Longhorn UI. Specify the nodes allowed to run Longhorn UI.
540
nodeSelector: {}
541
## If you want to set node selector for Longhorn UI Deployment, delete the `{}` in the line above
542
## and uncomment this example block
543
# label-key1: "label-value1"
544
# label-key2: "label-value2"
545
ingress:
546
# -- Setting that allows Longhorn to generate ingress records for the Longhorn UI service.
547
enabled: false
548
# -- IngressClass resource that contains ingress configuration, including the name of the Ingress controller.
549
# ingressClassName can replace the kubernetes.io/ingress.class annotation used in earlier Kubernetes releases.
550
ingressClassName: ~
551
# -- Hostname of the Layer 7 load balancer.
552
host: sslip.io
553
# -- Extra hostnames for TLS (Subject Alternative Names - SAN). Used when you need multiple FQDNs for the same ingress.
554
# Example:
555
# extraHosts:
556
# - longhorn.example.com
557
# - longhorn-ui.internal.local
558
extraHosts: []
559
# -- Setting that allows you to enable TLS on ingress records.
560
tls: false
561
# -- Setting that allows you to enable secure connections to the Longhorn UI service via port 443.
562
secureBackends: false
563
# -- TLS secret that contains the private key and certificate to be used for TLS. This setting applies only when TLS is enabled on ingress records.
564
tlsSecret: longhorn.local-tls
565
# -- Default ingress path. You can access the Longhorn UI by following the full ingress path {{host}}+{{path}}.
566
path: /
567
# -- Ingress path type. To maintain backward compatibility, the default value is "ImplementationSpecific".
568
pathType: ImplementationSpecific
569
## If you're using kube-lego, you will want to add:
570
## kubernetes.io/tls-acme: true
571
##
572
## For a full list of possible ingress annotations, please see
573
## ref: https://github.com/kubernetes/ingress-nginx/blob/master/docs/annotations.md
574
##
575
## If tls is set to true, annotation ingress.kubernetes.io/secure-backends: "true" will automatically be set
576
# -- Ingress annotations in the form of key-value pairs.
577
annotations:
578
# kubernetes.io/ingress.class: nginx
579
# kubernetes.io/tls-acme: true
580
581
# -- Secret that contains a TLS private key and certificate. Use secrets if you want to use your own certificates to secure ingresses.
582
secrets:
583
## If you're providing your own certificates, please use this to add the certificates as secrets
584
## key and certificate should start with -----BEGIN CERTIFICATE----- or
585
## -----BEGIN RSA PRIVATE KEY-----
586
##
587
## name should line up with a tlsSecret set further up
588
## If you're using kube-lego, this is unneeded, as it will create the secret for you if it is not set
589
##
590
## It is also possible to create and manage the certificates outside of this helm chart
591
## Please see README.md for more information
592
# - name: longhorn.local-tls
593
# key:
594
# certificate:
595
httproute:
596
# -- Setting that allows Longhorn to generate HTTPRoute records for the Longhorn UI service using Gateway API.
597
enabled: false
598
# -- Gateway references for HTTPRoute. Specify which Gateway(s) should handle this route.
599
parentRefs: []
600
## Example:
601
# - name: gateway-name
602
# namespace: gateway-namespace
603
# # Optional fields with defaults:
604
# # group: gateway.networking.k8s.io # default
605
# # kind: Gateway # default
606
# # sectionName: https # optional, targets a specific listener
607
# -- List of hostnames for the HTTPRoute. Multiple hostnames are supported.
608
hostnames: []
609
## Example:
610
# - longhorn.example.com
611
# - longhorn.example.org
612
# -- Default path for HTTPRoute. You can access the Longhorn UI by following the full path.
613
path: /
614
# -- Path match type for HTTPRoute. (Options: "Exact", "PathPrefix")
615
pathType: PathPrefix
616
# -- Annotations for the HTTPRoute resource in the form of key-value pairs.
617
annotations: {}
618
## Example:
619
# annotation-key1: "annotation-value1"
620
# -- Setting that allows you to enable pod security policies (PSPs) that allow privileged Longhorn pods to start. This setting applies only to clusters running Kubernetes 1.25 and earlier, and with the built-in Pod Security admission controller enabled.
621
enablePSP: false
622
# -- Specify override namespace, specifically this is useful for using longhorn as sub-chart and its release namespace is not the `longhorn-system`.
623
namespaceOverride: ""
624
# -- Annotation for the Longhorn Manager DaemonSet pods. This setting is optional.
625
annotations: {}
626
serviceAccount:
627
# -- Annotations to add to the service account
628
annotations: {}
629
metrics:
630
serviceMonitor:
631
# -- Setting that allows the creation of a Prometheus ServiceMonitor resource for Longhorn Manager components.
632
enabled: false
633
# -- Additional labels for the Prometheus ServiceMonitor resource.
634
additionalLabels: {}
635
# -- Annotations for the Prometheus ServiceMonitor resource.
636
annotations: {}
637
# -- Interval at which Prometheus scrapes the metrics from the target.
638
interval: ""
639
# -- Timeout after which Prometheus considers the scrape to be failed.
640
scrapeTimeout: ""
641
# -- Configures the relabeling rules to apply the target’s metadata labels. See the [Prometheus Operator
642
# documentation](https://prometheus-operator.dev/docs/api-reference/api/#monitoring.coreos.com/v1.Endpoint) for
643
# formatting details.
644
relabelings: []
645
# -- Configures the relabeling rules to apply to the samples before ingestion. See the [Prometheus Operator
646
# documentation](https://prometheus-operator.dev/docs/api-reference/api/#monitoring.coreos.com/v1.Endpoint) for
647
# formatting details.
648
metricRelabelings: []
649
## openshift settings
650
openshift:
651
# -- Setting that allows Longhorn to integrate with OpenShift.
652
enabled: false
653
ui:
654
# -- Route for connections between Longhorn and the OpenShift web console.
655
route: "longhorn-ui"
656
# -- Port for accessing the OpenShift web console.
657
port: 443
658
# -- Port for proxy that provides access to the OpenShift web console.
659
proxy: 8443
660
# -- Setting that allows Longhorn to generate code coverage profiles.
661
enableGoCoverDir: false
662
# -- Add extra objects manifests
663
extraObjects: []
664
The trusted source for open source
Talk to an expertProduct
Customers
© 2026 Chainguard, Inc. All Rights Reserved.
Chainguard® and the Chainguard logo are registered trademarks of Chainguard, Inc. in the United States and/or other countries.
The other respective trademarks mentioned on this page are owned by the respective companies and use of them does not imply any affiliation or endorsement.
Chainguard® and the Chainguard logo are registered trademarks of Chainguard, Inc. in the United States and/or other countries.
The other respective trademarks mentioned on this page are owned by the respective companies and use of them does not imply any affiliation or endorsement.