OpenEBS RawFile LocalPV is a Kubernetes CSI driver that provisions dynamically created node-local persistent volumes using loop-mounted filesystem extent files as emulated block devices.
The tool addresses the limitations of bind-mount-based local storage by creating dedicated filesystem extent files and associating them with Linux loop devices, effectively emulating block devices. This approach enables volume usage monitoring in constant time via standard filesystem tools, enforces hard size limits at the operating system level, and allows each volume to use different filesystems or custom filesystem options. The motivation for node-local storage centers on performance advantages over network-based solutions, reduced networking infrastructure requirements, and simpler operational complexity compared to distributed storage systems.
Developers should adopt this tool if they prioritize local storage performance and can accept node-local rather than replicated storage semantics. It suits on-premise environments where network-based storage infrastructure is costly or unavailable, and workloads that benefit from direct disk access without network overhead. The project explicitly compares itself to LocalPV-HostPath, another OpenEBS provisioner, noting that RawFile-LocalPV overcomes HostPath's inability to monitor volume usage efficiently, enforce size limits without performance penalties, or customize filesystems per volume. The project carries a pre-v1 status with a warning that Helm API and storage class parameters may have breaking changes.
The project maintains active development with regular commits addressing bug fixes and feature improvements. The codebase shows ongoing refinement of the CSI driver implementation and loop device management logic. Documentation is actively maintained with installation guides and comprehensive reference material in the docs directory. The project accepts community contributions through standard open-source channels.
