Docs Self-Managed Manage Kubernetes Storage Configure Storage PersistentVolume You are viewing the Self-Managed v24.3 beta documentation. We welcome your feedback at the Redpanda Community Slack #beta-feedback channel. To view the latest available version of the docs, see v24.2. Store the Redpanda Data Directory in PersistentVolumes You can configure Redpanda to use Kubernetes PersistentVolumes (PV) to store the Redpanda data directory using either a static provisioner or a dynamic provisioner. Prerequisites You must have the following: Kubernetes cluster: Ensure you have a running Kubernetes cluster, either locally, such as with minikube or kind, or remotely. Kubectl: Ensure you have the kubectl command-line tool installed and configured to communicate with your cluster. Storage resources: You need to set up the necessary storage resources in your Kubernetes cluster. File system: Ensure that the chosen volume is on an ext4 or XFS file system. Configure Redpanda to use PersistentVolumes Both the Redpanda Helm chart and the Redpanda custom resource provide an interface for configuring persistent storage. These are the default settings: Helm + Operator Helm redpanda-cluster.yaml apiVersion: cluster.redpanda.com/v1alpha2 kind: Redpanda metadata: name: redpanda spec: chartRef: {} clusterSpec: storage: persistentVolume: enabled: true size: 20Gi storageClass: "" labels: {} annotations: {} kubectl apply -f redpanda-cluster.yaml --namespace <namespace> --values --set redpanda-persistent-storage.yaml storage: persistentVolume: enabled: true size: 20Gi storageClass: "" labels: {} annotations: {} helm upgrade --install redpanda redpanda/redpanda --namespace <namespace> --create-namespace \ --values redpanda-persistent-storage.yaml --reuse-values helm upgrade --install redpanda redpanda/redpanda \ --namespace <namespace> \ --create-namespace \ --set storage.persistentVolume.enabled=true \ --set storage.persistentVolume.size=20Gi \ --set storage.persistentVolume.storageClass="" \ --set storage.persistentVolume.labels={} \ --set storage.persistentVolume.annotations={} storage.persistentVolume.enabled: Determines if a PersistentVolumeClaim (PVC) should be created for the Redpanda data directory. When set to true, a PVC is created. storage.persistentVolume.size: The size of the PVC. By default, it’s set to 20Gi, indicating a volume of 20 Gigabytes. Your underlying PV or StorageClass must support this size. storage.persistentVolume.storageClass: Specifies the StorageClass name for the PVC. If set to "-", dynamic provisioning is disabled. Leaving it undefined or empty uses the default dynamic provisioner. storage.persistentVolume.labels: For adding additional labels to the created PVC. storage.persistentVolume.annotations: For adding additional annotations to the created PVC. Verify PersistentVolumeClaims After configuring Redpanda for persistent storage, verify that the Redpanda Pods have claimed the required PV. Use the following command to list the PVCs in your cluster: kubectl get pvc --namespace <namespace> Ensure that the PVCs related to Redpanda are in the Bound state and note the PVs they’re bound to. Choose a Pod and describe it: kubectl describe pod <redpanda-pod-name> --namespace <namespace> In the output, ensure the PVC is mounted to the correct path and that the source PV matches what you’ve configured. Suggested reading Supported Volume Types for Data in Redpanda For more details about PersistentVolumes, see the Kubernetes documentation. Redpanda Helm Specification Redpanda CRD Reference Next Steps After setting up persistent storage for Redpanda, monitor your storage usage. Monitoring storage helps to detect issues early, optimize performance, and plan capacity changes. Monitor disk usage in Redpanda. Volume health monitoring in Kubernetes. Enable rack awareness to minimize data loss in the event of a rack failure. Back to top × Simple online edits For simple changes, such as fixing a typo, you can edit the content directly on GitHub. Edit on GitHub Or, open an issue to let us know about something that you want us to change. Open an issue Contribution guide For extensive content updates, or if you prefer to work locally, read our contribution guide . Was this helpful? thumb_up thumb_down group Ask in the community mail Share your feedback group_add Make a contribution Configure Storage hostPath