| Troubleshooting: Mount Failure with XFS Filesystem | compatibility | all | Derek Su | 2025-07-03 |
| Troubleshooting: Storage Network CSI Plugin Restart Triggers Unintended Restart of RWX Migratable Volume Workload | storage network
rwx volume | v1.7.x
v1.8.0-v1.8.2
v1.9.0 | Chin-Ya Huang | 2025-06-30 |
| Troubleshooting: Migratable RWX volume migration stuck | Migratable RWX volume | all | Raphanus Lo | 2025-06-23 |
| Troubleshooting: Failed Replicas with Backing Images Remain On Evicted Nodes | longhorn manager | v1.9.0 and earlier versions | Raphanus Lo | 2025-06-05 |
| Troubleshooting: Orphan Engine Or Replica Instance | orphan | all | Raphanus Lo | 2025-05-19 |
| Troubleshooting: Recurring Job Pod stuck in pending state | recurring job | all | Chin-Ya Huang | 2025-03-20 |
| Troubleshooting: Resolving Backing Image Unavailability Issue | longhorn manager | all | Jack Lin | 2025-03-14 |
| Troubleshooting: Longhorn Manager Crashes Due To Backing Image Eviction | longhorn manager | v1.7.0-v1.7.3 and v1.8.0 | Jack Lin | 2025-03-07 |
| Troubleshooting: Backing Image Creation Is Stuck Or Has Failed | backing image | all | Jack Lin | 2025-03-06 |
| Troubleshooting: Two active engines during volume live migration | live migration | v1.4.3
v1.5.1 | Phan Le | 2025-02-07 |
| Troubleshooting: Longhorn Manager Stuck in CrashLoopBackOff State Due to Inaccessible Webhook | longhorn manager | >= v1.5.0 | Jack Lin | 2025-01-17 |
| Troubleshooting: Instance Manager Pods Are Restarted | instance manager | all | Jack Lin | 2024-12-12 |
| Troubleshooting: NoExecute taint prevents workloads from terminating | taint
detach | all | Eric Weber | 2024-07-02 |
| Troubleshooting: Orphan ISCSI Session Error | iscsi
tgt | all | Phan Le | 2024-06-28 |
| Failure to Attach Volumes After Upgrade to Longhorn v1.5.x | volume attach detach | See Applicable Versions | Phan Le | 2024-05-31 |
| Kubernetes resource revision frequency expectations | instruction
etcd | See Applicable Versions | Eric Weber | 2024-02-23 |
| SELinux and Longhorn | instruction
selinux
rke2
k3s | all | Eric Weber | 2023-11-21 |
| Troubleshooting: RWX Volume Fails to Be Attached Caused by `Protocol not supported` | RWX volume
NFS
Linux kernel | all | Derek Su | 2023-10-27 |
| Troubleshooting: fstrim doesn't work on old kernel | filesystem trim
Linux kernel | >= v1.4.0 | Phan Le | 2023-10-06 |
| Troubleshooting: Failed RWX mount due to connection timeout | NFS
RWX volume
sles
flannel | all | Eric Weber | 2023-09-05 |
| Space consumption guideline | instruction
snapshot | all, but some features are introduced in v1.4.0 or v1.5.0 | Shuo Wu | 2023-08-25 |
| Troubleshooting: Unexpected expansion leads to degradation or attach failure | expansion
replica
instance-manager | See Applicable Versions | Eric Weber | 2023-07-26 |
| Troubleshooting: Failure to delete orphaned Pod volume directory | csi | all | Ray Chang | 2023-07-20 |
| Troubleshooting: Volume attachment fails due to SELinux denials in Fedora downstream distributions | iscsi
selinux
rhel
rocky | all | Eric Weber | 2023-06-07 |
| Troubleshooting: Volumes Stuck in Attach/Detach Loop When Using Longhorn on OKD | iscsi | all | Jack Lin | 2023-02-09 |
| Troubleshooting: Velero restores Longhorn PersistentVolumeClaim stuck in the Pending state when using the Velero CSI Plugin version before v0.4.0 | restore | all | Ray Chang | 2022-12-15 |
| Analysis: Potential Data/Filesystem Corruption | data integrity | v1.1.x
v1.2.x that are < v1.2.6
v1.3.x that are < v1.3.2 | Derek Su
Phan Le | 2022-09-29 |
| Instruction: How To Migrate Longhorn Chart Installed In Old Rancher UI To The Chart In New Rancher UI | instruction
upgrade
migration | v1.2.x
v1.3.x | Phan Le | 2022-06-23 |
| Troubleshooting: Unable to access an NFS backup target | backup | all | James Lu | 2022-05-27 |
| Troubleshooting: Pod with `volumeMode: Block` is stuck in terminating | HA | all | Phan Le | 2022-04-06 |
| Troubleshooting: Instance manager pods are restarted every hour | instance manager | >= v1.0.1 | Phan Le | 2022-02-25 |
| Troubleshooting: Open-iSCSI on RHEL based systems | iscsi | all | Keith Lucas | 2022-02-22 |
| Troubleshooting: Upgrading volume engine is stuck in deadlock | longhorn upgrade | This happens when users upgrade Longhorn from version <= v1.1.1 to a newer version. | Phan Le | 2022-01-03 |
| Tip: Set Longhorn To Only Use Storage On A Specific Set Of Nodes | tip
scheduling | all | Phan Le | 2021-11-15 |
| Troubleshooting: Some old instance manager pods are still running after upgrade | longhorn upgrade | >= v0.8.0 | Derek Su | 2021-11-09 |
| Troubleshooting: Volume cannot be cleaned up after the node of the workload pod is down and recovered | pod cleanup | all | Derek Su | 2021-11-08 |
| Troubleshooting: DNS Resolution Failed | dns | all | JenTing Hsiao | 2021-10-26 |
| Troubleshooting: Generate pprof runtime profiling data | pprof | >= v1.1.2 | Derek Su | 2021-10-18 |
| Troubleshooting: Pod stuck in creating state when Longhorn volumes filesystem is corrupted | data integrity | all | Chin-Ya Huang
Derek Su | 2021-08-19 |
| Troubleshooting: None-standard Kubelet directory | csi | all | Chin-Ya Huang | 2021-06-18 |
| Troubleshooting: Longhorn default settings do not persist | setting | < v1.3.0 | Chin-Ya Huang | 2021-04-29 |
| Troubleshooting: Recurring job does not create new jobs after detaching and attaching volume | recurring job | all | Chin-Ya Huang | 2021-04-21 |
| Troubleshooting: Use Traefik 2.x as ingress controller | longhorn-ui | See Applicable Versions | JenTing Hsiao | 2021-04-20 |
| Troubleshooting: Create Support Bundle with cURL | support bundle | all | Chin-Ya Huang | 2021-04-12 |
| Troubleshooting: Longhorn RWX shared mount ownership is shown as nobody in consumer Pod | RWX volume | v1.1.0 | Chin-Ya Huang | 2021-03-31 |
| Troubleshooting: `MountVolume.SetUp failed for volume` due to multipathd on the node | csi
multipathd | all | Clark Hsu | 2021-03-16 |
| Troubleshooting: Longhorn-UI: Error during WebSocket handshake: Unexpected response code: 200 #2265 | longhorn-ui | Existing Longhorn versions < v1.1.0 upgrade to Longhorn >= v1.1.0. | Clark Hsu | 2021-03-09 |
| Troubleshooting: Longhorn volumes take a long time to finish mounting | csi | all | Phan Le | 2021-02-26 |
| Troubleshooting: `volume readonly or I/O error` | HA | all | Shuo Wu | 2021-01-08 |
| Troubleshooting: `volume pvc-xxx not scheduled` | scheduling
csi | all | Sheng Yang | 2020-10-22 |
