OpenEBS LocalPV RawFile Documentation

OpenEBS LocalPV RawFile (rawfile-localpv) is a CSI driver that dynamically provisions node-local Persistent Volumes backed by sparse/preallocated raw files ("extent files") attached via Linux loop devices. This gives you local-disk performance with the manageability of real block devices: enforced size limits, per-volume filesystems, snapshots, cloning, expansion and rich metrics.

Table of Contents

Getting Started

• Quickstart & User Guide — prerequisites, deployment, and first volume
• Install Guide — install, upgrade and uninstall instructions
• Examples — ready-to-apply manifests for common scenarios

User Guides

• Creating and Configuring Volumes — StorageClasses, PVCs, filesystem & block mode, thin/thick, deletion
• Snapshots & Restore — taking snapshots and restoring them into new PVCs
• Cloning Volumes — PVC-to-PVC copies
• Resizing Volumes — online volume expansion
• Storage Pools — multiple pools, capacity reservation, tiering

Reference

• Features — capability matrix and feature deep dives
• StorageClass Configuration — every parameter configurable via StorageClass
• Helm Chart Values — full list of chart values
• Monitoring & Metrics — Prometheus metrics reference

Internals

• Architecture — components, data flow, and volume lifecycle
• Task Manager Design — async task execution subsystem

Project

• Contributor Guide — building, testing and submitting changes
• Release Process
• Changelog