{
  "schema_version": 2,
  "id": "operate/kubernetes/recommendations/persistent-volumes",
  "title": "Use persistent volumes in Redis Enterprise clusters",
  "url": "https://redis.io/docs/latest/operate/kubernetes/8.2.0/recommendations/persistent-volumes/",
  "summary": "This section covers details about how persistent volumes are sized and specified for Redis Enterprise cluster deployments.",
  "content": "## Storage types\n\nRedis Enterprise for Kubernetes can only use storage classes supported by block storage. Block storage is mounted at the Kubernetes node level and utilizes EXT4 or XFS file systems. It can be sourced from enterprise-grade SANs or cloud environments such as EBS, Azure Managed Disks, or GCP persistent disks.\n\n\u003e [!WARNING]\n\u003e NFS, NFS-like, and multi-read-write/shared storage options are not supported. These types of storage are often slow and can cause locking behaviors that are incompatible with the requirements of database storage.\n\n## REC `persistentSpec` field \nTo deploy a Redis Enterprise cluster with Redis Enterprise operator the\nspec should include a *persistentSpec* section, in the\n*redis-enterprise-cluster.yaml* file:\n\n    spec:\n      nodes: 3\n      persistentSpec:\n       enabled: true\n       storageClassName: \"standard\"\n       volumeSize: \"23Gi\" #optional\n\nPersistence storage is a requirement for production deployments.\n\n\u003e [!NOTE]\n\u003e For **production deployments** of Redis Enterprise Cluster on Kubernetes,\n\u003e the Redis Enterprise Cluster (REC) must be deployed with persistence enabled.\n\u003e The REC deployment files in the [Kubernetes documentation](https://github.com/RedisLabs/redis-enterprise-k8s-docs) contain this declaration by default.\n\n## Volume size\n\n*volumeSize* is an optional definition. By default, if the definition is\nomitted, operator allocates five times (5x) the amount of memory (RAM)\ndefined for nodes (see example below), which is the recommended\npersistent storage size as described in the [Hardware\nrequirements](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/plan-deployment/hardware-requirements) article.\n\nTo explicitly specify the persistent storage size, use the *volumeSize*\nproperty as described in the example above.\n\nPersistent volume claims can be expanded, but not reduced after creation. See [Expand PersistentVolumeClaim (PVC)](https://redis.io/docs/latest/operate/kubernetes/re-clusters/expand-pvc) for details.\n\n\u003e [!NOTE]\n\u003e We recommend that you omit the volumeSize definition from the REC declaration\n\u003e so that the Redis Enterprise Cluster deployment on Kubernetes use the default volume size.\n\n## Storage class name\n\n*storageClassName* determines the Storage Class resource, which is\ndefined by the Kubernetes cluster administrator, to be used for\npersistent storage.\n\nDifferent Kubernetes distributions and different deployments use\ndifferent Storage Class resources.\n\nIn order to determine the Storage Class resources available for your K8s\ndeployment, use the following command:\n\n    kubectl get StorageClass\n\nTypically, AWS provides \"gp3\" as the Storage Class name while GKE uses \"standard.\"\nAzure provides two Storage Classes: \"default\" using HDDs, and \"managed-premium\" using SSDs.\n\nBelow is an example of a response to the command.\n\n|                         |                                                         |\n| ----------------------- | ------------------------------------------------------- |\n| *Name:*                 | *gp3*                                                   |\n| *IsDefaultClass:*       | *Yes*                                                   |\n| *Annotations:*          | *storageclass.beta.kubernetes.io/is-default-class=true* |\n| *Provisioner:*          | *kubernetes.io/aws-ebs*                                 |\n| *Parameters:*           | *encrypted=false,kmsKeyId=,type=gp3*                    |\n| *AllowVolumeExpansion:* | *\\\u003cunset\\\u003e*                                             |\n| *MountOptions:*         | *\\\u003cnone\\\u003e*                                              |\n| *ReclaimPolicy:*        | *Delete*                                                |\n| *VolumeBindingMode:*    | *Immediate*                                             |\n| *Events:*               | *\\\u003cnone\\\u003e*                                              |\n\n\u003e [!NOTE]\n\u003e storageClassName must be specified for this deployment type.\n\n\u003e [!WARNING]\n\u003e The storage class cannot be changed after deployment. Trying to change this value after deployment could result in unexpected and potentially damaging behavior.\n\nExample of the redisEnterpriseNodeResources definition:\n\n    redisEnterpriseNodeResources:\n      limits:\n        cpu: \"4000m\"\n        memory: 4Gi\n      requests:\n        cpu: \"4000m\"\n        memory: 4Gi\n",
  "tags": ["docs","operate","kubernetes"],
  "last_updated": "2026-10-19T14:33:15-05:00"
}