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

# VESSL Storage

VESSL Storage is the default, fully managed storage system provided by the VESSL platform. It is automatically created for each organization and cannot be deleted, ensuring continuous availability for all projects.

## Creating a volume in VESSL Storage

Volume is the basic storage unit in VESSL. There are two ways to create a volume, each optimized for different machine learning workflow scenarios.

<Note>In YAML, a volume in VESSL Storage is specified as `volume://vessl-storage/{volume-name}`. </Note>

### 1. User-generated volume

Users can create volumes to upload datasets or models that will be used in workloads.

<Steps>
  <Step title="Create a new volume">
    Navigate to **Storage > VESSL Storage** and click the `+ Create a new volume` button. Specify the volume name and click the `Create` button.

    <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/6aBA2WrBVZlPiuT8/images/storages/vessl-storage/new_volume.png?fit=max&auto=format&n=6aBA2WrBVZlPiuT8&q=85&s=08b848162f4750bf2af0aa175bb6f85f" width="1439" height="681" data-path="images/storages/vessl-storage/new_volume.png" />
  </Step>

  <Step title="Upload files to the volume">
    Click the `Add files` button in the volume and select the files in your local machine to upload.

    <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/6aBA2WrBVZlPiuT8/images/storages/vessl-storage/add_files.png?fit=max&auto=format&n=6aBA2WrBVZlPiuT8&q=85&s=236586bd900a10b983743523fb1c4292" width="1439" height="704" data-path="images/storages/vessl-storage/add_files.png" />
  </Step>

  <Step title="Import the volume to a run">
    When creating a run in the web console, create a new directory (e.g., `/dataset`), and import the volume of VESSL Storage as shown below.

    <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/6aBA2WrBVZlPiuT8/images/storages/vessl-storage/import_volume.png?fit=max&auto=format&n=6aBA2WrBVZlPiuT8&q=85&s=ec7701167c258fac297ab2afb4e146d7" width="1438" height="721" data-path="images/storages/vessl-storage/import_volume.png" />

    Alternatively, you can manually specify the volume in YAML editor as follows:

    ```yaml theme={null}
    import:
        /dataset: volume://vessl-storage/my-volume
    ```
  </Step>
</Steps>

### 2. Workload-generated volume

Volumes can also be created by a workload when exporting logs, checkpoints, and metrics to VESSL Storage. The volume name is automatically generated in this case.

<Steps>
  <Step title="Export a workload volume to storage">
    To export your workload's data to VESSL Storage, create a new directory (e.g., `/output`), and export to VESSL Storage as follows.

    <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/6aBA2WrBVZlPiuT8/images/storages/vessl-storage/export_volume.png?fit=max&auto=format&n=6aBA2WrBVZlPiuT8&q=85&s=81672a2e8b103f24e8c647ea49d35fc3" width="1440" height="726" data-path="images/storages/vessl-storage/export_volume.png" />

    Alternatively, you can manually specify the export in the YAML editor as follows.

    ```yaml theme={null}
     export:
         /output: volume://vessl-storage/
    ```
  </Step>

  <Step title="Locate the exported volume">
    Navigate to **Run > Files** to find the file tree of run execution.

    <Frame>
      <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/6aBA2WrBVZlPiuT8/images/storages/vessl-storage/run_files.png?fit=max&auto=format&n=6aBA2WrBVZlPiuT8&q=85&s=69647d8e66d69fdcea4292be9613f274" width="1439" height="560" data-path="images/storages/vessl-storage/run_files.png" />
    </Frame>

    Follow the export volume link to access the volume in the VESSL Storage.
  </Step>
</Steps>

## Tagging & Search

Whether your volume is user-generated or workload-generated, tagging allows for quick search and retrieval of data.

<Frame>
  <img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/6aBA2WrBVZlPiuT8/images/storages/vessl-storage/tagging.png?fit=max&auto=format&n=6aBA2WrBVZlPiuT8&q=85&s=eacb1206d656205573f43914a908de09" width="1101" height="411" data-path="images/storages/vessl-storage/tagging.png" />
</Frame>
