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

# inferless volumes

Manage Inferless volumes

```console theme={null}
$ inferless volume COMMAND [OPTIONS] [ARGS]...
```

**Commands**:

* `create`: Create a new volume.
* `cp`: Add a file or directory to a volume.
* `ls`: List files and directories within a volume.
* `rm`: Specify the Inferless path to the file.
* `list`: List all existing volumes.

**Usage**:

Create a new volume

```console theme={null}
$ inferless volume create [OPTIONS]
```

**Options**:

* `-n, --name TEXT`: Assign a name to the new volume.

**Examples**:

```console theme={null}
$ inferless volume create -n my-volume
```

You will be asked for the prompt

Prompt : 'Region'

List all the volumes

```console theme={null}
$ inferless volume list [OPTIONS]
```

**Options**:

* `-r, --region TEXT`: specify the region where you want to create the runtime.

**Examples**:

```console theme={null}
$ inferless volume list -r region-1
```

Copy files to a volume

```console theme={null}
$ inferless volume cp [OPTIONS]
```

**Options**:

* `-s, --source TEXT`: Specify the source path (either a local directory/file path or an Inferless path)
* `-d, --destination TEXT`: Specify the destination path (either a local directory/file path or an Inferless path)
* `-r, --recursive`: Recursively copy the contents of a directory to the destination.
* `--help`: Show this message and exit.

**Examples**:

To copy from local to remote volume

```console theme={null}
$ inferless volume cp -s /path/to/local/file -d infer://volume/region/<volume_name>/path/file
```

To copy from remote to local volume

```console theme={null}
$ inferless volume cp -s infer://volume/region/<volume_name>/path/file -d /path/to/local/file
```

List files and directories within a volume

```console theme={null}
$ inferless volume ls [OPTIONS]
```

**Options**:

* `PATH`: Specify the infer path to the directory \[required]

**Options**:

* `-d, --directory`: List only directories.
* `-f, --files`: List only files.
* `-r, --recursive`: Recursively list contents of directories.
* `--help`: Show this message and exit.

**Examples**:

```console theme={null}
$ inferless volume ls [PATH] [OPTIONS]
```

Remove a file or directory from a volume

```console theme={null}
$ inferless volume rm [OPTIONS]
```

**Options**:

* `-p, --path TEXT`: Infer Path to the file/dir your want to delete

**Examples**:

```console theme={null}
$ inferless volume rm -p infer://volume/region/<volume_name>/path/file
```