RATATOSKRATATOSK
Sign in

Longhorn

v1.12.1Storage & Data
Aug 14, 2026

CHECK 1OTHER 52

A maintenance release adds experimental V2 capabilities, changes security and CPU and storage configuration behavior, and corrects operator-facing defects. Legacy V2 linked-clone volumes require upgrade planning because their operations are restricted after the upgrade.

Check if affected (1)

  • breakingLegacy V2 linked-clone volumes

    Applies if you have V2 linked-clone volumes created in v1.12.0 or earlier.

    V2 linked-clone volumes created in v1.12.0 or earlier are marked as legacy and deprecated starting in v1.12.1. After upgrading to v1.12.1, these volumes can only be detached or deleted.

All 52 other recorded changesfixes 38 · additions 9 · value changes 5

fixes (38)

  • - [BACKPORT][v1.12.1][IMPROVEMENT] V2 volume write I/O stalls(~10s) when a replica is removed during migration [13310](https://github.com/longhorn/longhorn/issues/13310) - @hookak @chriscchien
  • - [BACKPORT][v1.12.1][BUG] Host OS nvmf-autoconnect connects kernel initiators to v2 replica subsystems, stalling volume attach/detach for minutes [13660](https://github.com/longhorn/longhorn/issues/13660) - @hookak @chriscchien
  • - [BACKPORT][v1.12.1][BUG] Longhorn Helm Chart NetworkPolicies do not honor new RKE2 "rke2-traefik" ingress controller [13665](https://github.com/longhorn/longhorn/issues/13665) - @COLDTURNIP @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] Longhorn may try to attach volumes to a node without valid IM pod during the clone [13640](https://github.com/longhorn/longhorn/issues/13640) - @yangchiu @shuo-wu
  • - [BACKPORT][v1.12.1][BUG] Backup Listing With More Than 1000 Backups fails on v2 volume due to an empty replica address in the backup status [13612](https://github.com/longhorn/longhorn/issues/13612) - @COLDTURNIP @chriscchien
  • - [BACKPORT][v1.12.1][BUG] Incorrect Web Link in GUI [13539](https://github.com/longhorn/longhorn/issues/13539) - @yangchiu @sushant-suse
  • - [BACKPORT][v1.12.1][BUG] Encrypted V2 volume size is 16MB short of the claimed size [13175](https://github.com/longhorn/longhorn/issues/13175) - @mantissahz @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] CSI pods do not respect anti-affinity preset update [13548](https://github.com/longhorn/longhorn/issues/13548) - @chriscchien @carterli0407-cell
  • - [BACKPORT][v1.12.1][BUG] Failed to add v2 block disk with virtio-scsi BDF path [13475](https://github.com/longhorn/longhorn/issues/13475) - @chriscchien @carterli0407-cell
  • - [BACKPORT][v1.12.1][BUG] V2 encrypted volume keeps switching between Attaching and Detaching state after expand operation [13562](https://github.com/longhorn/longhorn/issues/13562) - @mantissahz @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] GCS backup target: backup of large volume fails at final .cfg PUT with SignatureDoesNotMatch (residual of #12676 in v1.12.0) [13574](https://github.com/longhorn/longhorn/issues/13574) - @derekbit @chriscchien
  • - [BACKPORT][v1.12.1][BUG] Fail to restore a volume from a full backup if a previous backup is corrupted [13538](https://github.com/longhorn/longhorn/issues/13538) - @yangchiu @derekbit
  • - [BACKPORT][v1.12.1][BUG] Longhorn 1.12.0: AWS chunked encoding not supported with OCI S3 buckets [13478](https://github.com/longhorn/longhorn/issues/13478) - @derekbit @mantissahz @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] Error logs in longhorn-uninstall job [13549](https://github.com/longhorn/longhorn/issues/13549) - @yangchiu @c3y1huang
  • - [BACKPORT][v1.12.1][BUG] V2 Data Engine: UBLK fails with EINVAL on Linux kernel 6.17.0 [13274](https://github.com/longhorn/longhorn/issues/13274) - @chriscchien @carterli0407-cell
  • - [BACKPORT][v1.12.1][BUG] Kernel Workqueue Lockup and Unstable RKE2 Service After Enabling LH V2 in Harvester [13495](https://github.com/longhorn/longhorn/issues/13495) - @derekbit @chriscchien
  • - [BACKPORT][v1.12.1][BUG] V2 expansion can report success while the engine remains at the old size [13380](https://github.com/longhorn/longhorn/issues/13380) - @davidcheng0922 @chriscchien
  • - [BACKPORT][v1.12.1][BUG] FilesystemReadOnly never detected on kernel >= 6.12 — ext4 reports emergency_ro, not ro; read-only auto-remount silently inoperative [13482](https://github.com/longhorn/longhorn/issues/13482) - @yangchiu
  • - [BACKPORT][v1.12.1][BUG] csi.*ReplicaCount Helm values silently no-op on existing csi-* deployments (only applied at first creation) [13465](https://github.com/longhorn/longhorn/issues/13465) - @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] v2 volume may crash again after the auto reattachment [13337](https://github.com/longhorn/longhorn/issues/13337) - @shuo-wu @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] V2 Volume Cannot Be Attached When the Storage Network Is Enabled [13490](https://github.com/longhorn/longhorn/issues/13490) - @c3y1huang
  • - [BACKPORT][v1.12.1][BUG] v2 volume repeated replica reuse failure [13336](https://github.com/longhorn/longhorn/issues/13336) - @shuo-wu @chriscchien
  • - [BACKPORT][v1.12.1][BUG] V2 Encrypted Volume Restore Fails [13365](https://github.com/longhorn/longhorn/issues/13365) - @mantissahz @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] V2 backup/snapshot can leave NVMe/TCP frontend or dm device stale, causing pod EIO on attached volumes [13332](https://github.com/longhorn/longhorn/issues/13332) - @davidcheng0922 @chriscchien
  • - [BACKPORT][v1.12.1][BUG] (chart) ArgoCD OutOfSync when using Gateway API [13446](https://github.com/longhorn/longhorn/issues/13446) - @yangchiu
  • - [BACKPORT][v1.12.1][BUG] Migration Engine Can Be Unexpectedly Deleted If the Target Node Is Still in Readiness Transition [13367](https://github.com/longhorn/longhorn/issues/13367) - @COLDTURNIP @yangchiu
  • - [BACKPORT][v1.12.1][BUG] Recurring trim job fails with deadlock [13425](https://github.com/longhorn/longhorn/issues/13425) - @c3y1huang @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] volume expansion stuck [13368](https://github.com/longhorn/longhorn/issues/13368) - @shuo-wu @chriscchien
  • - [BACKPORT][v1.12.1][BUG] pvc resize fails after iscsid restart [13412](https://github.com/longhorn/longhorn/issues/13412) - @yangchiu @shuo-wu
  • - [BACKPORT][v1.12.1][BUG] expanding the volume fails [13384](https://github.com/longhorn/longhorn/issues/13384) - @chriscchien
  • - [BACKPORT][v1.12.1][BUG] System Backup RecurringJob retention prunes newest CR — sorts by Status.CreatedAt (zero for Error/racing CRs) [13209](https://github.com/longhorn/longhorn/issues/13209) - @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] CSI components may have 0 running replica during upgrade [13348](https://github.com/longhorn/longhorn/issues/13348) - @yangchiu @carterli0407-cell
  • - [BACKPORT][v1.12.1][BUG] Node update forces a complete rebuild [13357](https://github.com/longhorn/longhorn/issues/13357) - @mantissahz
  • - [BACKPORT][v1.12.1][BUG] Creating backup for a v2 volume may fail [13191](https://github.com/longhorn/longhorn/issues/13191) - @mantissahz
  • - [BACKPORT][v1.12.1][BUG] when uploading backup to S3 storage (NetApp appliance) it fails [13297](https://github.com/longhorn/longhorn/issues/13297) - @mantissahz
  • - [BACKPORT][v1.12.1][BUG] spdk interrupt mode value is missing in chart/values.yaml [13269](https://github.com/longhorn/longhorn/issues/13269) - @yangchiu
  • - [BACKPORT][v1.12.1][BUG] Transient SPDK lvol metadata failure can permanently fault a healthy v2 replica [13542](https://github.com/longhorn/longhorn/issues/13542) - @roger-ryao
  • - [BACKPORT][v1.12.1][BUG] v2 volume stuck attaching with Storage Network enabled because the EngineFrontend target uses the engine pod IP instead of StorageIP [13353](https://github.com/longhorn/longhorn/issues/13353) - @yangchiu @c3y1huang

additions (9)

  • Longhorn v1.12.1 introduces storage sharding as an experimental data protection and storage layout feature built on the V2 Data Engine.
  • - [BACKPORT][v1.12.1][UI][FEATURE] V2 Data Engine Fast Cloning [13672](https://github.com/longhorn/longhorn/issues/13672) - @shuo-wu @roger-ryao
  • - [BACKPORT][v1.12.1][FEATURE] V2 Data Engine Sharding - Experimental [13176](https://github.com/longhorn/longhorn/issues/13176) - @c3y1huang @chriscchien
  • - [BACKPORT][v1.12.1][FEATURE] Support Kubernetes CPU Manager for Longhorn V2 instance-manager SPDK CPU assignment [13320](https://github.com/longhorn/longhorn/issues/13320) - @yangchiu @mantissahz @Copilot
  • - [BACKPORT][v1.12.1][IMPROVEMENT] Allow configuring SPDK iobuf small pool size [13675](https://github.com/longhorn/longhorn/issues/13675) - @yangchiu @hookak
  • - [BACKPORT][v1.12.1][IMPROVEMENT] always setup NetworkPolicy for the internal communication [13439](https://github.com/longhorn/longhorn/issues/13439) - @COLDTURNIP @roger-ryao
  • - [BACKPORT][v1.12.1][IMPROVEMENT] Add metrics to collect information about V2 data engine usage [13262](https://github.com/longhorn/longhorn/issues/13262) - @derekbit @chriscchien
  • - [BACKPORT][v1.12.1][IMPROVEMENT] Allow configuring SPDK iobuf large pool size [13415](https://github.com/longhorn/longhorn/issues/13415) - @chriscchien @bachmanity1
  • - [BACKPORT][v1.12.1][IMPROVEMENT] Add metrics to collect information about LONGHORN_DISTRO [13253](https://github.com/longhorn/longhorn/issues/13253) - @derekbit @chriscchien

value changes (5)

  • - [BACKPORT][v1.12.1][IMPROVEMENT] Steer host RPS away from SPDK reactor cores [13502](https://github.com/longhorn/longhorn/issues/13502) - @bachmanity1 @roger-ryao
  • - [BACKPORT][v1.12.1][IMPROVEMENT] updateBackupCompressionMethod may write the Volume even when the method is unchanged [13480](https://github.com/longhorn/longhorn/issues/13480) - @yangchiu
  • - [BACKPORT][v1.12.1][IMPROVEMENT] Improving error transparency for volume attachment failure [13431](https://github.com/longhorn/longhorn/issues/13431) - @derekbit @chriscchien
  • - [BACKPORT][v1.12.1][IMPROVEMENT] Support mTLS encrypted communication for remaining gRPC services in instance manager [13299](https://github.com/longhorn/longhorn/issues/13299) - @COLDTURNIP @yangchiu
  • kill the child process when command execution times out
Add Longhorn to your stack

A weekly email arrives when a release needs action. Like the breaking changes in this release.

Add to stack →
Official release note ↗All Longhorn releases →