PageSourceSearch

https://longhornio.netlify.app/docs/1.12.0/

html longhornio.netlify.app collected 2026-10-03 11:01:13 UTC 57,393 bytes, 40 lines download raw bytes

1<!doctype html><html lang=en-us><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=description content="Cloud native distributed block storage for Kubernetes"><link rel=alternate type=application/rss+xml href=https://longhorn.io/docs/1.12.0/ title=Longhorn><link rel=canonical href=https://longhorn.io/docs/latest/><meta name=twitter:card content="summary"><meta name=twitter:image content="https://longhorn.io/img/logos/longhorn-icon-color.png"><meta name=twitter:image:alt content="Longhorn color logo"><meta property="og:url" content="https://longhorn.io/docs/1.12.0/"><meta property="og:title" content="Longhorn | The Longhorn Documentation"><meta property="og:description" content="Cloud native distributed block storage for Kubernetes"><meta property="og:type" content="article"><meta property="og:site_name" content="Longhorn"><meta property="og:image" content="https://longhorn.io/img/logos/longhorn-icon-color.png"><meta property="og:image:type" content="image/png"><meta property="og:image:alt" content="Longhorn color logo"><meta property="og:locale" content="en_US"><meta name=robots content="noindex"><title>Longhorn | Documentation</title><link rel=stylesheet href=/css/style.96fd8da97397d5f1567fd308b2e32328b993ed090ac56a6c3a3e6225f25d94e8.css integrity="sha256-lv2NqXOX1fFWf9MIsuMjKLmT7QkKxWpsOj5iJfJdlOg="><link rel=stylesheet href=https://cdn.jsdelivr.net/npm/@docsearch/css@3><link rel="shortcut icon" type=image/png sizes=32x32 href=/favicon.png>
vendor: 64 bytes, lines 1-2
1
2<script async src="https://www.googletagmanager.com/gtag/js?id=
2G-7FVLP2S3TJ
vendor: 11 bytes, line 2
2"></script>
2<script>
vendor: 127 bytes, lines 3-5
3window.dataLayer = window.dataLayer || [];
4function gtag(){dataLayer.push(arguments);}
5gtag('js', new Date()); gtag('config', '
5G-7FVLP2S3TJ
vendor: 4 bytes, line 5
5');
6</script>
6
7</head><body><div class=canvas id=canvas x-data="{ drawer: false }"><nav class="navbar is-fixed-top has-shadow" x-data="{ open: false }"><div class=navbar-brand><a class=navbar-item href=https://longhorn.io/><img src=/img/logos/longhorn-horizontal-color.png alt="Longhorn navbar logo">
8</a><a role=button class=navbar-burger data-target=menu aria-label=menu aria-expanded=false :class="{ 'is-active': open }" @click="open = !open" @click.away="open = false"><span aria-hidden=true></span>
9<span aria-hidden=true></span>
10<span aria-hidden=true></span></a></div><div class=navbar-menu id=menu :class="{ 'is-active': open }"><div class=navbar-end><div class="navbar-item is-hidden-touch"><p class="control has-icons-left"><div id=docsearch></div></p></div><nav class=navbar role=navigation aria-label="dropdown navigation"><div class="navbar-item has-dropdown is-hoverable"><a class="navbar-link is-arrowless" href=/docs/1.13.0><span class=has-text-weight-bold>Docs
11</span><span class="icon has-text-secondary"><ion-icon name=chevron-down-outline></ion-icon></span></a><div class=navbar-dropdown><a class=navbar-item href=/docs/1.13.0>1.13.0 (<strong>latest</strong>)
12</a><a class=navbar-item href=/docs/1.12.1>1.12.1
13</a><a class=navbar-item href=/docs/1.12.0>1.12.0
14</a><a class=navbar-item href=/docs/1.11.3>1.11.3
15</a><a class=navbar-item href=/docs/1.11.2>1.11.2
16</a><a class=navbar-item href=/docs/1.11.1>1.11.1
17</a><a class=navbar-item href=/docs/1.11.0>1.11.0</a><hr><a class=navbar-item href=/docs/1.14.0>1.14.0-dev
18</a><a class=navbar-item href=/docs/1.13.1>1.13.1-dev
19</a><a class=navbar-item href=/docs/1.12.2>1.12.2-dev
20</a><a class=navbar-item href=/docs/1.11.3>1.11.3-dev</a></div></div><div class="navbar-item has-dropdown is-hoverable"><a class="navbar-link is-arrowless" href=/docs/1.13.0><span class=has-text-weight-bold>Archived Docs
21</span><span class="icon has-text-secondary"><ion-icon name=chevron-down-outline></ion-icon></span></a><div class=navbar-dropdown><a class=navbar-item href=/docs/archives/1.10.2>1.10.2
22</a><a class=navbar-item href=/docs/archives/1.10.1>1.10.1
23</a><a class=navbar-item href=/docs/archives/1.10.0>1.10.0
24</a><a class=navbar-item href=/docs/archives/1.9.2>1.9.2
25</a><a class=navbar-item href=/docs/archives/1.8.3>1.8.3
26</a><a class=navbar-item href=/docs/archives/1.7.3>1.7.3
27</a><a class=navbar-item href=/docs/archives/1.6.4>1.6.4
28</a><a class=navbar-item href=/docs/archives/1.5.5>1.5.5
29</a><a class=navbar-item href=/docs/archives/1.4.4>1.4.4
30</a><a class=navbar-item href=/docs/archives/1.3.3>1.3.3
31</a><a class=navbar-item href=/docs/archives/1.2.6>1.2.6
32</a><a class=navbar-item href=/docs/archives/1.1.3>1.1.3</a></div></div></nav><a class="navbar-item has-text-weight-bold" href=/blog><span>Blog
33</span></a><a class="navbar-item has-text-weight-bold" href=/kb><span>Knowledge Base
34</span></a><a class="navbar-item has-text-weight-bold" href=/community><span>Community
35</span></a><a class="navbar-item has-text-weight-bold" href=/enterprise><span>Enterprise</span></a><div class=navbar-item><div class="buttons is-left"><a class="button is-black has-text-weight-bold" href=https://github.com/longhorn/longhorn target=_blank><span class=icon><ion-icon name=logo-github></ion-icon></span><span>GitHub
36</span></a><a class="button is-black has-text-weight-bold" href=https://cloud-native.slack.com/messages/longhorn target=_blank><span class=icon><ion-icon name=logo-slack></ion-icon></span><span>Slack</span></a></div></div></div></div></nav><nav class="navbar is-black is-hidden-desktop under-nav"><div class=navbar-brand><div class="navbar-item is-hidden-desktop"><a class="button is-black is-borderless has-text-weight-light" @click="drawer = !drawer"><span class=icon><ion-icon name=list></ion-icon></span><span>Docs</span></a></div></div></nav><div class=dashboard><div class="dashboard-panel sidebar is-hidden-touch"><aside class="nav is-sidebar"><div class=nav-section><a class="nav-section-title is-active" href=/docs/1.12.0/>The Longhorn Documentation</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/what-is-longhorn/>What is Longhorn?</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/concepts/>Architecture and Concepts</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/terminology/>Terminology</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/best-practices/>Best Practices</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/data-engine-comparison/>Data Engine Comparison</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/document-conventions/>Document Conventions</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/contributing/>Contributing</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/important-notes/>Important Notes</a></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/deploy/>Installation and Setup</a><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/deploy/install/>Quick Installation</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-rancher/>Install as a Rancher Apps & Marketplace</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-kubectl/>Install with Kubectl</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-helm/>Install with Helm</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-helm-controller/>Install with Helm Controller</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-fleet/>
36Install with Fleet</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-flux/>Install with Flux</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-argocd/>Install with ArgoCD</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/airgap/>Air Gap Installation</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/deploy/accessing-the-ui/>Accessing the UI</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/accessing-the-ui/longhorn-ingress/>Create an Ingress with Basic Authentication (nginx)</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/accessing-the-ui/longhorn-ingress-traefik/>Create an Ingress with Basic Authentication (Traefik)</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/accessing-the-ui/longhorn-httproute/>Create an HTTPRoute with Gateway API</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/deploy/upgrade/>Upgrade</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/longhorn-manager/>Upgrading Longhorn Manager</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/upgrade-engine/>Manually Upgrading Longhorn Engine</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/auto-upgrade-engine/>Automatically Upgrading Longhorn Engine</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/instance-manager-pods-during-upgrade/>Instance Manager Pods During Upgrade</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/deploy/uninstall/>Uninstall Longhorn</a></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/maintenance/>Maintenance and Upgrade</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/maintenance/maintenance/>Node Maintenance and Kubernetes Upgrade Guide</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/nodes-and-volumes/>Nodes and Volumes</a><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/nodes-and-volumes/nodes/>Nodes</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link>
36<a href=/docs/1.12.0/nodes-and-volumes/nodes/node-space-usage/>Node Space Usage</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/storage-tags/>Storage Tags</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/default-disk-and-node-config/>Configuring Defaults for Nodes and Disks</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/multidisk/>Multiple Disk Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/scheduling/>Scheduling</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/disks-or-nodes-eviction/>Evicting Replicas on Disabled Disks or Nodes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/topology-aware-provisioning/>Topology-Aware Provisioning</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/graceful-node-removal/>Graceful Node Removal</a></li><li class=nav-sub-section-pages-link>
36<a href=/docs/1.12.0/nodes-and-volumes/nodes/node-conditions/>Node Conditions</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/nodes-and-volumes/volumes/>Volumes</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/create-volumes/>Create Longhorn Volumes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/pvc-ownership-and-permission/>Longhorn PVC Ownership and Permission</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/delete-volumes/>Delete Longhorn Volumes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/detaching-volumes/>Detach Longhorn Volumes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/rwx-volumes/>ReadWriteMany (RWX) Volume</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/iscsi/>Use Longhorn Volume as an iSCSI Target</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/volume-size/>Volume Size</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/workload-identification/>Viewing Workloads that Use a Volume</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/expansion/>Volume Expansion</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/trim-filesystem/>Trim Filesystem</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/volume-conditions/>Volume Conditions</a></li></ul></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/high-availability/>High Availability</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/auto-balance-replicas/>Auto Balance Replicas</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/data-locality/>Data Locality</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/k8s-cluster-autoscaler/>Kubernetes Cluster Autoscaler Support (Experimental)</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/rwx-volume-fast-failover/>RWX Volume Fast Failover (Experimental)</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/recover-volume/>Volume Recovery</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/node-failure/>Node Failure Handling with Longhorn</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/snapshots-and-backups/>Backup and Restore</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/setup-a-snapshot/>Create a Snapshot</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/snapshot-space-management/>Snapshot Space Management</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/scheduling-backups-and-snapshots/>Recurring Snapshots and Backups</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-volume-clone/>Volume Clone Support</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/setup-disaster-recovery-volumes/>Disaster Recovery (DR) Volumes</a></li></ul><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/>Backup and Restore</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/set-backup-target/>Setting a Backup Target</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/configure-backup-block-size/>Configure The Block Size Of Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/create-a-backup/>Create a Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/restore-from-a-backup/>Restore from a Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/restore-statefulset/>Restoring Volumes for Kubernetes StatefulSets</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/restore-recurring-jobs-from-a-backup/>Restore Volume Recurring Jobs from a Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/synchronize_backup_volumes_manually/>Synchronize Backup Volumes Manually</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/>CSI Snapshot Support</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/enable-csi-snapshot-support/>Enable CSI Snapshot Support on a Cluster</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/csi-volume-snapsh
36ot-associated-with-longhorn-backing-image/>CSI VolumeSnapshot Associated with Longhorn BackingImage</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/csi-volume-snapshot-associated-with-longhorn-snapshot/>CSI VolumeSnapshot Associated with Longhorn Snapshot</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/csi-volume-snapshot-associated-with-longhorn-backup/>CSI VolumeSnapshot Associated with Longhorn Backup</a></li></ul></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/monitoring/>Monitoring</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/prometheus-and-grafana-setup/>Setting up Prometheus and Grafana to monitor Longhorn</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/integrating-with-rancher-monitoring/>Integrating Longhorn metrics into the Rancher monitoring system</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/metrics/>Longhorn Metrics for Monitoring</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/disk-heath/>Disk Health Monitoring</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/kubelet-volume-metrics/>Kubelet Volume Metrics Support</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/alert-rules-example/>Longhorn Alert Rule Examples</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/advanced-resources/>Advanced Resources</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/advanced-resources/volumeattachment/>Longhorn VolumeAttachment</a></li></ul><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/deploy/>Deploy</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/customizing-default-settings/>Customizing Default Settings</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/taint-toleration/>Taints and Tolerations</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/node-selector/>Node Selector</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/csi-pod-antiaffinity-preset/>CSI Component Pod Anti-Affinity</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/rancher_windows_cluster/>Rancher Windows Cluster</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/priority-class/>Priority Class</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/revision_counter/>Revision Counter</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/storage-network/>Storage Network</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/os-distro-specific/>OS/Distro Specific Configuration</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/csi-on-k3s/>Longhorn CSI on K3s</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/csi-on-rke-and-coreos/>Longhorn CSI on RKE and CoreOS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/csi-on-gke/>Longhorn CSI on GKE</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/okd-support/>OCP/OKD Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/container-optimized-os-support/>Container-Optimized OS (COS) Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/talos-linux-support/>Talos Linux Support</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/>Support Managed Kubernetes Service</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/manage-node-group-on-eks/>Manage Node-Group on AWS EKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/manage-node-group-on-aks/>Manage Node-Group on Azure AKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/manage-node-group-on-gke/>Manage Node-Group on GCP GKE</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/upgrade-k8s-on-eks/>Upgrade Kubernetes on AWS EKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/upgrade-k8s-on-aks/>Upgrade Kubernetes on Azure AKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/upgrade-k8s-on-gke/>Upgrade Kubernetes on GCP GKE</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/data-integrity/>Data Integrity</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-integrity/on-demand-snapshot-data-integrity/>On-Demand Snapshot Checksum Calculation</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-integrity/snapshot-data-integrity-check/>Snapshot Data Integrity Check</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/data-cleanup/>Data Cleanup</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-cleanup/orphaned-data-cleanup/>Orphaned Data Cleanup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-cleanup/orphaned-instance-cleanup/>Orphaned Instance Cleanup</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/rebuilding/>
36Replica Rebuilding</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/fast-replica-rebuilding/>Fast Replica Rebuilding</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/offline-replica-rebuilding/>Offline Replica Rebuilding</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/replica-rebuild-qos/>Replica Rebuild QoS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/scale-replica-rebuilding/>Scale Replica Rebuilding</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/backing-image/>Backing Image</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/backing-image/backing-image/>Backing Image</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/backing-image/backing-image-backup/>Backing Image Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/backing-image/backing-image-encryption/>Backing Image Encryption</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/security/>Security</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/security/volume-encryption/>Volume Encryption</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/security/mtls-support/>MTLS Support</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/longhornctl/>Command Line Tool (longhornctl)</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/longhornctl/install-longhornctl/>Install longhornctl</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/containerized-data-importer/>Containerized Data Importer (CDI)</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/containerized-data-importer/containerized-data-importer/>Longhorn with CDI Imports</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/system-backup-restore/>Longhorn System Backup And Restore</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/backup-longhorn-system/>Backup Longhorn System</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/restore-longhorn-system/>Restore Longhorn System</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/restore-to-a-cluster-contains-data-using-rancher-snapshot/>Restore to a cluster contains data using Rancher snapshot</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/restore-to-a-new-cluster-using-velero/>Restore to a new cluster using Velero</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/cluster-restore/>Cluster Restore</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/cluster-restore/rancher-cluster-restore/>Restore cluster with a Rancher snapshot</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/data-recovery/>Data Recovery</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/data-error/>Identifying and Recovering from Data Errors</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/export-from-replica/>Exporting a Volume from a Single Replica</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/corrupted-replica/>Identifying Corrupted Replicas</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/full-disk/>Recovering from a Full Disk</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/recover-without-system/>Recovering from a Longhorn Backup without System Installed</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/driver-migration/>CSI Driver Migration</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/driver-migration/migrating-flexvolume/>Migrating from the Flexvolume Driver to CSI</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/v2-data-engine/>V2 Data Engine</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/configurable-cpu-cores/>Configurable CPU Cores</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/hugepage-configuration/>Huge Page Configuration</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/selective-v2-data-engine-activation/>Selective V2 Data Engine Activation</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/interrupt-mode/>Interrupt Mode Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/ublk-frontend-support/>UBLK Frontend Support (Experimental)</a></li></ul></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/references/>References</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/references/settings/>
36Settings</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/storage-class-parameters/>Storage Class Parameters</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/longhorn-client-python/>Python Client</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/reference-setup-performance-scalability-and-sizing-guidelines/>Reference Setup, Performance, Scalability, and Sizing Guidelines</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/networking/>Longhorn Networking</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/examples/>Examples</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/helm-values/>Helm Values</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/troubleshoot/>Troubleshoot</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/troubleshoot/troubleshooting/>Troubleshooting Problems</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/troubleshoot/support-bundle/>Support Bundle</a></li></ul></div></aside></div><div class="dashboard-panel main"><section class="hero is-primary is-medium is-bold"><div class=hero-body><div class=container><div class=docs-content><p class="title is-size-2 is-size-3-mobile has-text-weight-bold is-spaced">The Longhorn Documentation</p><p class="subtitle is-size-3 is-size-4-mobile has-text-weight-light">Cloud native distributed block storage for Kubernetes</p></div><div class=buttons><a class="button is-small" href=https://github.com/longhorn/website/edit/master/content/docs/1.12.0/_index.md target=_blank><span class=icon><ion-icon name=logo-github></ion-icon></span><span>Edit this page</span></a></div></div></div></section><section class=section><div class=container><div class=docs-content><div class="content has-extra-bottom-padding"><p><strong>Longhorn</strong> is a lightweight, reliable, and powerful distributed <a href=https://cloudacademy.com/blog/object-storage-block-storage/>block storage</a> system for Kubernetes.</p><p>Longhorn implements distributed block storage using containers and microservices. Longhorn creates a dedicated storage controller for each block device volume and synchronously replicates the volume across multiple replicas stored on multiple nodes. The storage controller and replicas are themselves orchestrated using Kubernetes.</p><h2 id=features>Features</h2><ul><li>Enterprise-grade distributed block storage with no single point of failure</li><li>Incremental snapshot of block storage</li><li>Backup to secondary storage (<a href=https://www.extrahop.com/resources/protocols/nfs/>NFS</a> or <a href=https://aws.amazon.com/s3/>S3</a>-compatible object storage) built on efficient change block detection</li><li>Recurring snapshots and backups</li><li>Automated, non-disruptive upgrades. You can upgrade the entire Longhorn software stack without disrupting running storage volumes.</li><li>An intuitive GUI dashboard</li></ul></div></div></div></section><section class=hero><div class=hero-body><div class=container><hr><p class=has-text-weight-light>Copyright &copy; 2019-2026 Longhorn a Series of LF Projects, LLC.
37Documentation Distributed under <a href=https://creativecommons.org/licenses/by/4.0/ target=_blank>CC-BY-4.0</a>.</p><br><p class=has-text-weight-light>The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our
38<a href=https://www.linuxfoundation.org/trademark-usage target=_blank>Trademark Usage</a> page.</p><br><p class=has-text-weight-light>For website terms of use, trademark policy and other project policies please see
39<a href=https://lfprojects.org/policies/ target=_blank>lfprojects.org/policies</a>.</p><br><span class="icon-text has-text-info is-pulled-right mx-3"><a href=https://k3s.io/ target=_blank><span class=icon><img src=/img/project-icons/icon-k3s.svg title=K3s>
40</span></a></span><span class="icon-text has-text-success is-pulled-right mx-3"><a href=https://harvesterhci.io/ target=_blank><span class=icon><img src=/img/project-icons/icon-harvester.svg title=Harvester></span></a></span></div></div></section></div></div><div class=drawer :class="{ 'is-visible': drawer }"><aside class="nav is-drawer"><span class="icon is-hoverable" @click="drawer = !drawer"><ion-icon size=large name=close-circle-outline></ion-icon></span><div class=nav-section><a class="nav-section-title is-active" href=/docs/1.12.0/>The Longhorn Documentation</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/what-is-longhorn/>What is Longhorn?</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/concepts/>Architecture and Concepts</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/terminology/>Terminology</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/best-practices/>Best Practices</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/data-engine-comparison/>Data Engine Comparison</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/document-conventions/>Document Conventions</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/contributing/>Contributing</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/important-notes/>Important Notes</a></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/deploy/>Installation and Setup</a><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/deploy/install/>Quick Installation</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-rancher/>Install as a Rancher Apps & Marketplace</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-kubectl/>Install with Kubectl</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-helm/>Install with Helm</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-helm-controller/>Install with Helm Controller</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-fleet/>
40Install with Fleet</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-flux/>Install with Flux</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/install-with-argocd/>Install with ArgoCD</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/install/airgap/>Air Gap Installation</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/deploy/accessing-the-ui/>Accessing the UI</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/accessing-the-ui/longhorn-ingress/>Create an Ingress with Basic Authentication (nginx)</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/accessing-the-ui/longhorn-ingress-traefik/>Create an Ingress with Basic Authentication (Traefik)</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/accessing-the-ui/longhorn-httproute/>Create an HTTPRoute with Gateway API</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/deploy/upgrade/>Upgrade</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/longhorn-manager/>Upgrading Longhorn Manager</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/upgrade-engine/>Manually Upgrading Longhorn Engine</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/auto-upgrade-engine/>Automatically Upgrading Longhorn Engine</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/deploy/upgrade/instance-manager-pods-during-upgrade/>Instance Manager Pods During Upgrade</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/deploy/uninstall/>Uninstall Longhorn</a></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/maintenance/>Maintenance and Upgrade</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/maintenance/maintenance/>Node Maintenance and Kubernetes Upgrade Guide</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/nodes-and-volumes/>Nodes and Volumes</a><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/nodes-and-volumes/nodes/>Nodes</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link>
40<a href=/docs/1.12.0/nodes-and-volumes/nodes/node-space-usage/>Node Space Usage</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/storage-tags/>Storage Tags</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/default-disk-and-node-config/>Configuring Defaults for Nodes and Disks</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/multidisk/>Multiple Disk Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/scheduling/>Scheduling</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/disks-or-nodes-eviction/>Evicting Replicas on Disabled Disks or Nodes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/topology-aware-provisioning/>Topology-Aware Provisioning</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/nodes/graceful-node-removal/>Graceful Node Removal</a></li><li class=nav-sub-section-pages-link>
40<a href=/docs/1.12.0/nodes-and-volumes/nodes/node-conditions/>Node Conditions</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/nodes-and-volumes/volumes/>Volumes</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/create-volumes/>Create Longhorn Volumes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/pvc-ownership-and-permission/>Longhorn PVC Ownership and Permission</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/delete-volumes/>Delete Longhorn Volumes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/detaching-volumes/>Detach Longhorn Volumes</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/rwx-volumes/>ReadWriteMany (RWX) Volume</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/iscsi/>Use Longhorn Volume as an iSCSI Target</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/volume-size/>Volume Size</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/workload-identification/>Viewing Workloads that Use a Volume</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/expansion/>Volume Expansion</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/trim-filesystem/>Trim Filesystem</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/nodes-and-volumes/volumes/volume-conditions/>Volume Conditions</a></li></ul></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/high-availability/>High Availability</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/auto-balance-replicas/>Auto Balance Replicas</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/data-locality/>Data Locality</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/k8s-cluster-autoscaler/>Kubernetes Cluster Autoscaler Support (Experimental)</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/rwx-volume-fast-failover/>RWX Volume Fast Failover (Experimental)</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/recover-volume/>Volume Recovery</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/high-availability/node-failure/>Node Failure Handling with Longhorn</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/snapshots-and-backups/>Backup and Restore</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/setup-a-snapshot/>Create a Snapshot</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/snapshot-space-management/>Snapshot Space Management</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/scheduling-backups-and-snapshots/>Recurring Snapshots and Backups</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-volume-clone/>Volume Clone Support</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/setup-disaster-recovery-volumes/>Disaster Recovery (DR) Volumes</a></li></ul><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/>Backup and Restore</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/set-backup-target/>Setting a Backup Target</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/configure-backup-block-size/>Configure The Block Size Of Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/create-a-backup/>Create a Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/restore-from-a-backup/>Restore from a Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/restore-statefulset/>Restoring Volumes for Kubernetes StatefulSets</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/restore-recurring-jobs-from-a-backup/>Restore Volume Recurring Jobs from a Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/backup-and-restore/synchronize_backup_volumes_manually/>Synchronize Backup Volumes Manually</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/>CSI Snapshot Support</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/enable-csi-snapshot-support/>Enable CSI Snapshot Support on a Cluster</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/csi-volume-snapsh
40ot-associated-with-longhorn-backing-image/>CSI VolumeSnapshot Associated with Longhorn BackingImage</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/csi-volume-snapshot-associated-with-longhorn-snapshot/>CSI VolumeSnapshot Associated with Longhorn Snapshot</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/snapshots-and-backups/csi-snapshot-support/csi-volume-snapshot-associated-with-longhorn-backup/>CSI VolumeSnapshot Associated with Longhorn Backup</a></li></ul></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/monitoring/>Monitoring</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/prometheus-and-grafana-setup/>Setting up Prometheus and Grafana to monitor Longhorn</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/integrating-with-rancher-monitoring/>Integrating Longhorn metrics into the Rancher monitoring system</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/metrics/>Longhorn Metrics for Monitoring</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/disk-heath/>Disk Health Monitoring</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/kubelet-volume-metrics/>Kubelet Volume Metrics Support</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/monitoring/alert-rules-example/>Longhorn Alert Rule Examples</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/advanced-resources/>Advanced Resources</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/advanced-resources/volumeattachment/>Longhorn VolumeAttachment</a></li></ul><div class=nav-sub-section><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/deploy/>Deploy</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/customizing-default-settings/>Customizing Default Settings</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/taint-toleration/>Taints and Tolerations</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/node-selector/>Node Selector</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/csi-pod-antiaffinity-preset/>CSI Component Pod Anti-Affinity</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/rancher_windows_cluster/>Rancher Windows Cluster</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/priority-class/>Priority Class</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/revision_counter/>Revision Counter</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/deploy/storage-network/>Storage Network</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/os-distro-specific/>OS/Distro Specific Configuration</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/csi-on-k3s/>Longhorn CSI on K3s</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/csi-on-rke-and-coreos/>Longhorn CSI on RKE and CoreOS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/csi-on-gke/>Longhorn CSI on GKE</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/okd-support/>OCP/OKD Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/container-optimized-os-support/>Container-Optimized OS (COS) Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/os-distro-specific/talos-linux-support/>Talos Linux Support</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/>Support Managed Kubernetes Service</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/manage-node-group-on-eks/>Manage Node-Group on AWS EKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/manage-node-group-on-aks/>Manage Node-Group on Azure AKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/manage-node-group-on-gke/>Manage Node-Group on GCP GKE</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/upgrade-k8s-on-eks/>Upgrade Kubernetes on AWS EKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/upgrade-k8s-on-aks/>Upgrade Kubernetes on Azure AKS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/support-managed-k8s-service/upgrade-k8s-on-gke/>Upgrade Kubernetes on GCP GKE</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/data-integrity/>Data Integrity</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-integrity/on-demand-snapshot-data-integrity/>On-Demand Snapshot Checksum Calculation</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-integrity/snapshot-data-integrity-check/>Snapshot Data Integrity Check</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/data-cleanup/>Data Cleanup</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-cleanup/orphaned-data-cleanup/>Orphaned Data Cleanup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-cleanup/orphaned-instance-cleanup/>Orphaned Instance Cleanup</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/rebuilding/>
40Replica Rebuilding</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/fast-replica-rebuilding/>Fast Replica Rebuilding</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/offline-replica-rebuilding/>Offline Replica Rebuilding</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/replica-rebuild-qos/>Replica Rebuild QoS</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/rebuilding/scale-replica-rebuilding/>Scale Replica Rebuilding</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/backing-image/>Backing Image</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/backing-image/backing-image/>Backing Image</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/backing-image/backing-image-backup/>Backing Image Backup</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/backing-image/backing-image-encryption/>Backing Image Encryption</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/security/>Security</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/security/volume-encryption/>Volume Encryption</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/security/mtls-support/>MTLS Support</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/longhornctl/>Command Line Tool (longhornctl)</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/longhornctl/install-longhornctl/>Install longhornctl</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/containerized-data-importer/>Containerized Data Importer (CDI)</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/containerized-data-importer/containerized-data-importer/>Longhorn with CDI Imports</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/system-backup-restore/>Longhorn System Backup And Restore</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/backup-longhorn-system/>Backup Longhorn System</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/restore-longhorn-system/>Restore Longhorn System</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/restore-to-a-cluster-contains-data-using-rancher-snapshot/>Restore to a cluster contains data using Rancher snapshot</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/system-backup-restore/restore-to-a-new-cluster-using-velero/>Restore to a new cluster using Velero</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/cluster-restore/>Cluster Restore</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/cluster-restore/rancher-cluster-restore/>Restore cluster with a Rancher snapshot</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/data-recovery/>Data Recovery</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/data-error/>Identifying and Recovering from Data Errors</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/export-from-replica/>Exporting a Volume from a Single Replica</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/corrupted-replica/>Identifying Corrupted Replicas</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/full-disk/>Recovering from a Full Disk</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/data-recovery/recover-without-system/>Recovering from a Longhorn Backup without System Installed</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/driver-migration/>CSI Driver Migration</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/driver-migration/migrating-flexvolume/>Migrating from the Flexvolume Driver to CSI</a></li></ul><a class=nav-sub-section-title href=/docs/1.12.0/advanced-resources/v2-data-engine/>V2 Data Engine</a><ul class=nav-sub-section-pages><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/configurable-cpu-cores/>Configurable CPU Cores</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/hugepage-configuration/>Huge Page Configuration</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/selective-v2-data-engine-activation/>Selective V2 Data Engine Activation</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/interrupt-mode/>Interrupt Mode Support</a></li><li class=nav-sub-section-pages-link><a href=/docs/1.12.0/advanced-resources/v2-data-engine/ublk-frontend-support/>UBLK Frontend Support (Experimental)</a></li></ul></div></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/references/>References</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/references/settings/>
40Settings</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/storage-class-parameters/>Storage Class Parameters</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/longhorn-client-python/>Python Client</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/reference-setup-performance-scalability-and-sizing-guidelines/>Reference Setup, Performance, Scalability, and Sizing Guidelines</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/networking/>Longhorn Networking</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/examples/>Examples</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/references/helm-values/>Helm Values</a></li></ul></div><div class=nav-section><a class=nav-section-title href=/docs/1.12.0/troubleshoot/>Troubleshoot</a><ul class=nav-section-pages><li class=nav-section-pages-link><a href=/docs/1.12.0/troubleshoot/troubleshooting/>Troubleshooting Problems</a></li><li class=nav-section-pages-link><a href=/docs/1.12.0/troubleshoot/support-bundle/>Support Bundle</a></li></ul></div></aside></div></div>
40<script src=https://cdn.jsdelivr.net/gh/alpinejs/[email protected]/dist/alpine.min.js defer></script>
40<script type=module src=https://unpkg.com/[email protected]/dist/ionicons/ionicons.esm.js></script>
40<script nomodule src=https://unpkg.com/[email protected]/dist/ionicons/ionicons.js></script>
40<script src=https://cdnjs.cloudflare.com/ajax/libs/anchor-js/4.2.2/anchor.min.js></script>
40<script src=https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js></script>
40<script src=/js/jquery.matchHeight.js></script>
40<script src=/js/scripts.js></script>
40<script>anchors.options={icon:"#"},document.addEventListener("DOMContentLoaded",function(){anchors.add(".content h1, .content h2, .content h3, .content h4, .content h5, .content h6")})</script>
40<script>const navbarHeight=document.getElementsByClassName("navbar")[0].offsetHeight,extraPadding=15,navbarOffset=-1*(navbarHeight+extraPadding);var shiftWindow=function(){scrollBy(0,navbarOffset)};window.addEventListener("hashchange",shiftWindow),window.addEventListener("pageshow",shiftWindow);function load(){window.location.hash&&shiftWindow()}</script>
40<script src=https://cdn.jsdelivr.net/npm/@docsearch/js@3></script>
40<script type=text/javascript>docsearch({appId:"TS07WNTQHJ",apiKey:"9e0cd43a8301a11f0ede922e0cb66625",indexName:"longhorn",container:"#docsearch",searchParameters:{facetFilters:["version:1.12.0"]},debug:!1})</script>
40</body></html>

Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.