Skip to main content
Manage network volumes for persistent shared storage across Pods and Serverless endpoints.

Alias

You can use nv as a shorthand for network-volume:

Subcommands

List network volumes

List all your network volumes:

Get network volume details

Get detailed information about a specific network volume:

Create a network volume

Create a new network volume:

Create flags

string
required
Volume name.
int
required
Volume size in GB (10-4096).
string
required
Datacenter ID where the volume will be created. Use runpodctl datacenter list to see available datacenters.

Update a network volume

Update network volume configuration:

Update flags

string
New volume name.
int
New volume size in GB. Must be larger than the current size.

Upload files

Upload a file or folder to a network volume:
The remote path is optional and defaults to the local name. A file uploaded to a remote path that ends in / keeps its name inside that folder, and a folder’s contents land under the remote path.

Download files

Download a file or folder from a network volume:
The local path is optional and defaults to the remote name. Use / as the remote path to download the whole volume.

Requirements for upload and download

Both commands need runpodctl v3.1.0 or later. They use the network volume’s S3-compatible API, so they also need the following:
  • S3 API keys, which are separate from your Runpod API key. Create them in your account settings, then set the RUNPOD_S3_ACCESS_KEY and RUNPOD_S3_SECRET_KEY environment variables, pass the flags below, or set s3AccessKey and s3SecretKey in ~/.runpod/config.toml.
  • A data center that supports the S3-compatible API. The CLI looks up the volume’s data center with your Runpod API key. Pass --data-center-id to skip the lookup.
Transfers resume. If one stops because of a network drop or an interruption, run the same command again: finished files are skipped, and a large file continues from the parts already transferred. Files are also skipped when the destination copy has the same size and isn’t older.

Upload and download flags

int
Number of parallel requests, from 1 to 64 (default 4).
string
The volume’s data center ID, such as EU-RO-1. By default, the CLI looks it up from the volume.
bool
Transfer every file, including files that the size and time check treats as unchanged. Use it after an edit that kept a file the same size.
string
S3 API access key. Defaults to the RUNPOD_S3_ACCESS_KEY environment variable.
string
S3 API secret key. Defaults to the RUNPOD_S3_SECRET_KEY environment variable.

Delete a network volume

Delete a network volume:
Deleting a network volume permanently removes all data stored on it. Make sure to back up any important data before deleting.
Last modified on November 14, 2026