Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
February 9, 2023 02:22
December 20, 2022 06:29
January 2, 2023 05:24
November 16, 2022 10:23
February 20, 2023 10:13
November 16, 2022 10:23
November 16, 2022 10:23
July 27, 2021 01:47
June 19, 2021 22:02
March 3, 2023 10:11
November 16, 2022 10:23
February 21, 2023 01:45
March 28, 2022 07:20
December 20, 2022 06:29

TopoLVM logo GitHub release Main PkgGoDev Go Report Card


TopoLVM is a CSI plugin using LVM for Kubernetes. It can be considered as a specific implementation of local persistent volumes using CSI and LVM.

  • Project Status: Testing for production
  • Conformed CSI version: 1.5.0

Our supported platform are:

  • Kubernetes: 1.25, 1.24, 1.23
  • Node OS: Linux with LVM2 (*1)
  • Filesystems: ext4, xfs, btrfs(experimental)
  • lvm version 2.02.163 or later (adds JSON output support)

*1 The host's Linux Kernel must be v4.9 or later which supports rmapbt and reflink, if you use xfs filesystem with an official docker image.

Docker images are available on
Please note that the images on are deprecated and will be removed in the future.

Getting started

A demonstration of TopoLVM running on kind (Kubernetes IN Docker) is available at example directory.

For production deployments, see deploy/

User manual is at docs/

Deprecated: If you want to use TopoLVM on Rancher/RKE, see docs/deprecated/


TopoLVM project welcomes contributions from any member of our community. To get started contributing, please see our Contributing Guide.


In Scope

  • Dynamic provisioning: Volumes are created dynamically when PersistentVolumeClaim objects are created.
  • Raw block volume: Volumes are available as block devices inside containers.
  • Topology: TopoLVM uses CSI topology feature to schedule Pod to Node where LVM volume exists.
  • Extended scheduler: TopoLVM extends the general Pod scheduler to prioritize Nodes having larger storage capacity.
  • Volume metrics: Usage stats are exported as Prometheus metrics from kubelet.
  • Volume Expansion: Volumes can be expanded by editing PersistentVolumeClaim objects.
  • Storage capacity tracking: You can enable Storage Capacity Tracking mode instead of using topolvm-scheduler.

Planned features

Deprecated features

  • Pod security policy support is deprecated and will be removed when TopoLVM removes the support of Kubernetes < v1.25. This policy is same as Kubernetes.


If you have any questions or ideas, please use discussions.


docs directory contains the user manual, designs and specifications, and so on.

A diagram of components is available in docs/

TopoLVM maintainers presented the motivation and implementation of TopoLVM at KubeCon Europe 2020:


This project is licensed under Apache License 2.0.