> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akua.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Storage
> Add persistent storage to your clusters so applications can store data that survives restarts and upgrades
Most applications need to store data that persists beyond the lifetime of a single container: databases, file uploads, caches, and configuration. Kubernetes handles this through persistent volumes, which provide storage that survives pod restarts, upgrades, and rescheduling.
Before your applications can use persistent storage, your cluster needs a StorageClass (a definition of what storage is available and how volumes are created). Akua provides two built-in storage providers you can deploy with one click, or you can use your own.
## Built-in storage providers
Akua includes two storage providers that cover development through production:
Direct local disk storage with the lowest latency. Ideal for development, single-node setups, and databases that handle their own replication.
Replicated block storage across multiple nodes with synchronous or asynchronous replication. Automatic failover on node failure.
## Choosing a provider
The key question is: **who handles data replication, the storage layer or your application?**
| | Local Path Provisioner | Piraeus (LINSTOR) |
| ---------------------- | -------------------------------------- | ---------------------------------------------------- |
| **Replication** | None (your application must handle it) | Storage-level, across nodes |
| **Failover** | Application-managed | Automatic (pods reschedule to a node with a replica) |
| **Volume size limits** | Not enforced (volumes are directories) | Enforced at the block device level |
| **Volume expansion** | Not supported | Supported |
| **Snapshots** | No | Yes |
| **Write latency** | Lowest (direct to local disk) | Depends on replication mode (sync or async) |
If your databases already replicate data across instances (like PostgreSQL streaming replication or MongoDB replica sets), Local Path Provisioner on NVMe SSDs gives you the best raw performance. If you want the storage layer to handle durability for you, use Piraeus.
## Deploy a storage provider
In your [cluster dashboard](https://akua.dev/clusters), select your cluster and navigate to the **Storage** tab.
If no storage provider is installed, you'll see an empty state with a **Deploy Storage** button. Click it to open the provider selection sheet.
Select **Local Path Provisioner** for development or **Piraeus (LINSTOR)** for production. Each card shows the provider's features and trade-offs.
Click **Deploy Storage**. The provider is deployed to your cluster as a standard application. A default StorageClass is created automatically, so your applications can request storage right away.
After deployment, the Storage tab shows your available StorageClasses with their provisioner, reclaim policy, and binding mode.
## Imported clusters
If you're using an [imported cluster](/clusters/import), you may already have storage configured by your cloud provider or infrastructure team:
* **Managed Kubernetes** (EKS, GKE, AKS): these typically come with a default StorageClass backed by cloud block storage (EBS, Persistent Disk, Azure Disk). Check your cluster's Storage tab to confirm.
* **Self-managed clusters**: you can deploy Akua's built-in providers, or use a CSI driver from your infrastructure provider. For example, if your VMs run on Hetzner, consider the [Hetzner CSI driver](https://github.com/hetznercloud/csi-driver) to provision cloud volumes directly.
Akua's built-in providers work on any cluster, managed or imported. If your cloud provider already supplies storage, you don't need to deploy an additional provider unless you want different storage characteristics (like replication across nodes).
## How applications use storage
When an application requests persistent storage through a PersistentVolumeClaim, Kubernetes automatically provisions a volume using your cluster's default StorageClass. Your Package resources declare the storage they need, and the cluster handles the rest.
Common applications that require persistent storage:
* Databases (PostgreSQL, MySQL, Redis, MongoDB)
* File storage and media uploads
* Message queues (RabbitMQ, Kafka)
* Search engines (Elasticsearch, Meilisearch)
## Related topics
Set up a managed cluster to deploy storage on.
Connect compute capacity to your cluster.
Connect your existing Kubernetes cluster.
Understand how clusters work in Akua.