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

> ## Agent Instructions
> Use the documentation index to find relevant pages, then read the linked Markdown before answering and cite the source URL.
> Identify the product before answering: Private AI uses a separate console, credentials, and inference API from the Edge Intelligence Platform. Do not apply instructions from one product to the other.
> Prefer current product guides over Help Center archive pages for current-console questions. Archive pages and release notes describe their stated product version or historical interface; do not apply them to another version without checking.
> Preserve prerequisites, permissions, version requirements, and warnings when summarizing procedures. Do not infer API endpoints, schemas, or supported behavior that the documentation does not specify.

# Create Volumes

> Create Image Volume or Block Storage volume instances on a node or cluster in Edge Infrastructure Services.

## Introduction

This procedure explains how to create a volume instance in Edge Infrastructure Services. A volume instance provides storage on a node for an edge application to store its working copy, runtime data, and logs. You create volume instances on a specific node or cluster.

There are two volume types:

* **Image Volume**: Downloads an immutable application image from your datastore to the node. Edge applications use this as a read-only base image.
* **Block Storage**: Provides writable storage for application data. You specify the access mode, maximum size, and optionally initialize the volume from an existing image volume.

If your application does not require persistent data, Edge Infrastructure Services sets up storage automatically when you deploy the application instance and no manual volume creation is required.

## Prerequisites

* You have the SysManager or SysAdmin role in your enterprise. See [Manage Roles](https://zededa.mintlify.site/new-ui/infrastructure-services/administration/manage-roles.md).
* At least one node onboarded to Edge Infrastructure Services. If creating a cluster volume, at least one cluster configured.
* For Image Volume type: at least one app image available in your enterprise.

## Navigate to Volumes

1. In the sidebar, click **Infrastructure > Workloads > Volumes**.
2. Click the **Add** button (floating button in the lower right of the page).
3. On the volume type selector, choose **Image Volume** or **Block Storage**, then click **Next** to proceed to the creation wizard.

## Configure Identity

In the **Identity** section:

1. In the **Name** field, enter a unique identifier for the volume. The name cannot contain spaces and cannot be changed after creation.
2. In the **Title** field, enter a human-readable display label. The title defaults to the name you entered and can be changed later.
3. In the **Description** field, enter an optional description.
4. In the **Target Type** field, select whether this volume will be created on a **Node** or a **Node Cluster**.
5. In the **Node** or **Node Cluster** field, select the target from the dropdown. The volume is created on this node when deployed.
6. Click **Next**.

## Configure Storage

### Image Volume

In the **Storage** section for an Image Volume:

1. In the **App Image** field, select the application image that will back this volume. The image is downloaded from the datastore associated with it.
2. Click **Create Volume**.

Image volumes are always read-only. Access mode is set to Read Only automatically.

### Block Storage

In the **Storage** section for Block Storage:

1. In the **Access Mode** field, select the appropriate access permission:
   * **Read Only**: Applications can read from this volume but cannot write to it.
   * **Read Write**: Applications can read from and write to this volume.
   * **Multi Read / Single Write**: Behaves the same as Read Write. Multiple applications can read; writes are handled as single-writer access.
2. In the **Max Size** field, enter a value and select a unit (B, KB, MB, GB, or TB). This sets the maximum storage space the volume can use on the node.
3. In the **Image Volume** field, optionally select an existing image volume to use as the initial content for this block storage volume. If you leave this field empty, the volume starts blank.
4. Use the **Encryption** toggle to enable encryption at rest. When enabled, EVE-OS (Edge Virtualization Engine) encrypts the volume data on the node.
5. Click **Create Volume**.

## Verify the Creation

After creation, Edge Infrastructure Services returns you to the **Volumes** list. Locate the new volume and confirm its **Run State** is progressing toward **Online**. The time to reach the Online state depends on the volume type and the size of any image being downloaded.

## Next Steps

> [card] [Manage Volumes](https://zededa.mintlify.site/new-ui/infrastructure-services/volumes/manage-volumes.md)
>
> Update the volume title and description, or delete the volume.

> [card] [Add Persistent Volumes](https://zededa.mintlify.site/new-ui/infrastructure-services/volumes/add-persistent-volumes.md)
>
> Learn how to prevent volume data from being erased during application updates.

> [card] [Attach Volumes to Multiple Applications](https://zededa.mintlify.site/new-ui/infrastructure-services/volumes/attach-volumes-to-multiple-applications.md)
>
> Share a volume between multiple edge applications on the same node.