For users who prefer full control over their data or have existing storage infrastructures, External Storage provides the flexibility to integrate cloud or on-premise storage solutions directly into the VESSL platform. This allows users to connect their preferred storage without migrating data into VESSL.

​
Integrate External Storage

In YAML, external storage volumes are specified as volume://{storage-name}/{volume-name}.

​
1. Cloud object storage

VESSL supports AWS S3 and Google Cloud Storage as external cloud storage options. Follow the steps below to integrate cloud storage:

1

Integrate cloud credentials

Integrating AWS S3 or Google Cloud Storage is straightforward. Navigate to Organization settings > Integrations and add your credentials.

2

Integrate external storage

After adding credentials, integrate your external storage using the bucket path. Click Test connection to validate the credentials, and then click Integrate.

3

Create a new volume

Create a volume in the external storage for use in workloads.

You cannot create files or folders directly in External Storage volumes. These must be managed at the source.
4

Import the volume to run

When creating a run in the web console, create a directory (e.g., /dataset) and import the volume from External Storage as follows:

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

import:
    /dataset: volume://{storage-name}/{volume-name}
5

Export a workload volume to storage

To export your workload’s data to External Storage, create a new directory (e.g., /output), and export the data as follows:

Alternatively, you can manually specify the export in the YAML editor:

 export:
     /output: volume://{storage-name}/
6

Locate the exported volume

Navigate to Run > Files to find he file tree of the executed run.

Follow the export volume link to access the data in External Storage.

​
2. On-Premise Storage

VESSL supports NFS (Network File System) and host path volumes for users who maintain on-premise storage solutions. You can integrate and use data from on-premise storage by following these steps:

1

Integrate external storage

On-premise storage is bound to a specific cluster.
Integrate external storage with the NFS or host path options. Click theIntegrate button.

2

Mount the volume to a run

NFS volumes can be directly mounted to runs, reducing initialization time and making it ideal for large datasets.

Alternatively, you can manually specify the mount in the YAML editor:

mount:
  /mnt: volume://{storage-name}/{volume-name}

Similar to VESSL Storage, you can tag external storage volumes for easy search and retrieval. Tags are supported across both cloud and on-premise storage, ensuring a consistent experience.