---
sidebar_position: 20
---

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

# `lium volumes`

Manage persistent volumes that can be attached to pods.

```bash
lium volumes SUBCOMMAND [OPTIONS]
```

Running `lium volumes` with no subcommand defaults to `list`.

## Subcommands

| Subcommand | Purpose |
|------------|---------|
| `list` | List your volumes |
| `new NAME [--desc DESC]` | Create a new volume |
| `rm INDICES [-y]` | Delete volumes by index from `list` |

### `lium volumes list`

```bash
lium volumes list
```

The output assigns each volume a numeric index, used by `rm`. The HUID column is what you pass to [`lium up --volume id:<HUID>`](./up.md).

### `lium volumes new NAME`

| Flag | Effect |
|------|--------|
| `-d, --desc TEXT` | Volume description |

```bash
lium volumes new training-data
lium volumes new datasets --desc "ImageNet 2012"
```

### `lium volumes rm INDICES`

| Flag | Effect |
|------|--------|
| `-y, --yes` | Skip the confirmation prompt |

```bash
lium volumes rm 1                    # Delete volume #1
lium volumes rm 1,2,5                # Multiple
lium volumes rm 1 -y                 # No confirmation
```

A volume must be detached before it can be deleted.

## Attaching to a pod

```bash
lium up 1 --volume id:brave-fox-3a                       # Existing volume
lium up 1 --volume new:name=training,desc="ML data"      # Create + attach
```

## See also

- [Volumes](/pod-users/volumes) — concept guide
- [`lium up`](./up.md) — attach a volume at pod creation