> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primeintellect.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cluster storage

> Configure persistent and ephemeral shared storage for multi-node clusters

Multi-node clusters support two types of shared storage: persistent disks that survive beyond cluster lifecycles, and ephemeral shared storage that exists only during the cluster's lifetime.

## Storage Options

### Persistent Storage

* **Persists** after cluster termination
* **Shareable** across multiple clusters
* **Requires** pre-created disk with `Active` status
* **Use case**: Long-term data, models, and datasets

### Ephemeral Shared Storage

* **Temporary** storage for cluster lifecycle only
* **Automatic** creation during cluster provisioning
* **Shared** between all nodes in the cluster
* **Use case**: Temporary files, intermediate processing data

# Step-by-Step Guide

<Steps>
  <Step title="Go to `Multi-Node Cluster` and select a provider. For persistent storage, ensure the provider and location match your existing disk. Look for the `Add Shared Filesystem` button.">
    <Frame>
      <img src="https://mintcdn.com/primeintellect/u4gd9w_CirhPniY2/images/shared-disk/cluster-with-shared-disk.png?fit=max&auto=format&n=u4gd9w_CirhPniY2&q=85&s=ab3be28f6c7e9352b4dc848015e13c72" alt="Cluster with disk" width="1600" height="945" data-path="images/shared-disk/cluster-with-shared-disk.png" />
    </Frame>
  </Step>

  <Step title="To use existing persistent storage, click `Add Shared Filesystem` and select your disk.">
    <Frame>
      <img src="https://mintcdn.com/primeintellect/u4gd9w_CirhPniY2/images/shared-disk/cluster-with-shared-disk2.png?fit=max&auto=format&n=u4gd9w_CirhPniY2&q=85&s=b1fed4728ee90f3c2b6ee678f1ee909f" alt="Provision with disk" width="1600" height="1481" data-path="images/shared-disk/cluster-with-shared-disk2.png" />
    </Frame>

    <Note>This disk will remain available after cluster termination and can be reattached to new clusters.</Note>
  </Step>

  <Step title="For temporary shared storage, simply enter the desired size in GB. This creates a new shared filesystem that's accessible by all nodes but will be deleted when the cluster terminates.">
    <Frame>
      <img src="https://mintcdn.com/primeintellect/u4gd9w_CirhPniY2/images/shared-disk/cluster-with-shared-disk3.png?fit=max&auto=format&n=u4gd9w_CirhPniY2&q=85&s=2a8e9af8063cfd55c211b0fa5fca0764" alt="Shared disk for cluster" width="1600" height="1481" data-path="images/shared-disk/cluster-with-shared-disk3.png" />
    </Frame>

    <Warning>Ephemeral storage is deleted when the cluster terminates. Do not store critical data here without backups.</Warning>
  </Step>
</Steps>