# Chalk CLI Reference: Volumes
source: https://docs.chalk.ai/cli#volumes

Create and manage named volumes for persistent object storage. Upload, download, and manage files within volumes.

## `chalk volume create`
source: https://docs.chalk.ai/cli?command=volume_create

```bash
chalk volume create <volume-uri>
```

Create a new volume

**Arguments**

- `volume-uri` (string)
  New Chalk Volume URI in chalk://volume form.

**Example**

```
$ chalk volume create chalk://my-data
```

## `chalk volume ls`
source: https://docs.chalk.ai/cli?command=volume_ls

```bash
chalk volume ls [volume-uri]
```

List volumes, or list files when a Chalk Volume URI is provided.

A Chalk Volume URI identifies a volume, an optional fork or version, and an optional file path.

- chalk://VOLUME/PATH
- chalk://VOLUME:FORK/PATH
- chalk://VOLUME@VERSION/PATH
- chalk://VOLUME@TIMESTAMP/PATH

A Chalk Volume URI cannot select both a fork and a version.

**Arguments**

- `volume-uri` (string)
  Chalk Volume URI in chalk://volume[:fork][@version][/path] form.

**Flags**

- `--limit <count>` (int, default `100`)
  Maximum number of items per page
- `--cursor <token>` (string)
  Continue from a cursor returned by a previous request
- `--all-pages <all-pages>` (bool, default `false`)
  Fetch every page
- `--prefix <prefix>` (string)
  Only list volumes whose names start with this prefix

**Example**

```
$ chalk volume ls
$ chalk volume ls chalk://my-data/models
$ chalk volume ls chalk://my-data:experiment/models
$ chalk volume ls chalk://my-data@3 --all-pages
$ chalk volume ls --prefix my-
```

## `chalk volume cp`
source: https://docs.chalk.ai/cli?command=volume_cp

```bash
chalk volume cp <source> <destination>
```

Copy between a local path and a Chalk Volume URI. One side must be local and the other must begin with chalk://. Use `-` for standard input or output.

A Chalk Volume URI identifies a volume, an optional fork or version, and an optional file path.

- chalk://VOLUME/PATH
- chalk://VOLUME:FORK/PATH
- chalk://VOLUME@VERSION/PATH
- chalk://VOLUME@TIMESTAMP/PATH

A Chalk Volume URI cannot select both a fork and a version.

**Arguments**

- `source` (string)
  Local path or Chalk Volume URI.
- `destination` (string)
  Local path or Chalk Volume URI.

**Flags**

- `-r, --recursive <recursive>` (bool, default `false`)
  Copy directories and their contents
- `--skip-non-regular <skip-non-regular>` (bool, default `false`)
  Skip symlinks and other non-regular files in recursive uploads

**Example**

```
$ chalk volume cp ./local-model.bin chalk://my-data/models/latest.bin
$ chalk volume cp chalk://my-data/models/latest.bin ./downloaded-model.bin
$ chalk volume cp --recursive ./models chalk://my-data/models
$ chalk volume cp chalk://my-data/data.csv -
$ echo "hello" | chalk volume cp - chalk://my-data/hello.txt
```

## `chalk volume cat`
source: https://docs.chalk.ai/cli?command=volume_cat

```bash
chalk volume cat <volume-uri>
```

Write one file from a Chalk Volume URI to standard output.

A Chalk Volume URI identifies a volume, an optional fork or version, and an optional file path.

- chalk://VOLUME/PATH
- chalk://VOLUME:FORK/PATH
- chalk://VOLUME@VERSION/PATH
- chalk://VOLUME@TIMESTAMP/PATH

A Chalk Volume URI cannot select both a fork and a version.

**Arguments**

- `volume-uri` (string)
  Chalk Volume URI in chalk://volume[:fork][@version]/path form.

**Example**

```
$ chalk volume cat chalk://my-data/logs/error.log | grep timeout
```

## `chalk volume rm`
source: https://docs.chalk.ai/cli?command=volume_rm

```bash
chalk volume rm <volume-uri>
```

Remove a file from a volume, or delete an entire volume

**Arguments**

- `volume-uri` (string)
  Chalk Volume URI in chalk://volume[:fork]/path form, or chalk://volume to delete the entire volume.

**Flags**

- `-f, --force <force>` (bool, default `false`)
  Delete without confirmation

**Example**

```
$ chalk volume rm chalk://my-volume/model.pkl
$ chalk volume rm chalk://my-volume:experiment/model.pkl --force
$ chalk volume rm chalk://my-volume
```

## `chalk volume fork`
source: https://docs.chalk.ai/cli?command=volume_fork

```bash
chalk volume fork
```

Create, list, and delete forks using explicit subcommands.

A Chalk Volume URI identifies a volume, an optional fork or version, and an optional file path.

- chalk://VOLUME/PATH
- chalk://VOLUME:FORK/PATH
- chalk://VOLUME@VERSION/PATH
- chalk://VOLUME@TIMESTAMP/PATH

A Chalk Volume URI cannot select both a fork and a version.

**Example**

```
$ chalk volume fork create chalk://my-data chalk://my-data:experiment
$ chalk volume fork list chalk://my-data
$ chalk volume fork delete chalk://my-data:experiment
```

## `chalk volume fork create`
source: https://docs.chalk.ai/cli?command=volume_fork_create

```bash
chalk volume fork create <source-volume-uri> <volume-uri>
```

Create a fork

**Arguments**

- `source-volume-uri` (string)
  Source Chalk Volume URI selecting a volume, fork, or version.
- `volume-uri` (string)
  New fork as a Chalk Volume URI in chalk://volume:fork form.

**Example**

```
$ chalk volume fork create chalk://my-data@3 chalk://my-data:experiment
```

## `chalk volume fork list`
source: https://docs.chalk.ai/cli?command=volume_fork_list

```bash
chalk volume fork list <volume-uri>
```

List forks

**Arguments**

- `volume-uri` (string)
  Chalk Volume URI in chalk://volume form.

**Example**

```
$ chalk volume fork list chalk://my-data
```

## `chalk volume fork delete`
source: https://docs.chalk.ai/cli?command=volume_fork_delete

```bash
chalk volume fork delete <volume-uri>
```

Delete a fork

**Arguments**

- `volume-uri` (string)
  Chalk Volume URI in chalk://volume:fork form.

**Flags**

- `-f, --force <force>` (bool, default `false`)
  Delete without confirmation

**Example**

```
$ chalk volume fork delete chalk://my-data:experiment
```

## `chalk volume info`
source: https://docs.chalk.ai/cli?command=volume_info

```bash
chalk volume info <volume-uri>
```

Show volume details

**Arguments**

- `volume-uri` (string)
  Chalk Volume URI selecting a volume, fork, or version.

**Flags**

- `--limit <count>` (int, default `100`)
  Maximum number of items per page
- `--cursor <token>` (string)
  Continue from a cursor returned by a previous request
- `--all-pages <all-pages>` (bool, default `false`)
  Fetch every page

**Example**

```
$ chalk volume info chalk://my-volume
$ chalk volume info chalk://my-volume:experiment
$ chalk volume info chalk://my-volume@3 --all-pages
```
