---
description: "Create, attach, resize, and delete Verda block volumes and shared filesystems from the command line, and inspect what each instance currently has mounted."
revision_date: 04.08.2026
---

# Storage

Use the Verda CLI to create and manage block storage volumes. Volumes provide persistent storage that can be attached to instances and survive instance deletion.

***

#### Create a volume

```bash
verda volume create \
  --name "training-data" \
  --size 500 \
  --type NVMe \
  --location FIN-01
```

To wait until the volume is ready:

```bash
verda volume create --name "training-data" --size 500 --wait
```

| Flag | Description |
|------|-------------|
| `--name` | Volume name |
| `--size` | Size in GiB |
| `--type` | Volume type. `NVMe` is the only provisionable type and the default, so you can omit this flag (HDD is deprecated). |
| `--location` | Datacenter location |
| `--wait` | Wait until the volume is ready |

***

#### List volumes

View all your volumes:

```bash
verda volume list
```

***

#### Describe a volume

Get detailed information about a specific volume:

```bash
verda volume describe <volume-id>
```

***

#### Volume actions

`verda volume action` opens an interactive picker: select a volume, then choose an action — **Detach**, **Rename**, **Resize** (grow only), **Clone**, or **Delete**.

```bash
verda volume action
```

To act on a specific volume without the picker, pass `--id`. Add `--wait` to block until the action completes:

```bash
verda volume action --id <volume-id> --wait
```

***

#### Delete a volume

Deleting a volume is a **soft delete** — the volume moves to the trash, where it can be recovered within 96 hours before being permanently removed.

```bash
verda volume delete <volume-id>              # moves the volume to trash
verda volume delete --id <volume-id> --yes   # skip the confirmation prompt
```

`delete` (alias `rm`) also accepts `--all`, optionally narrowed with `--status` (e.g. `--status detached`), to delete volumes in bulk.

!!! warning
    Delete prompts for confirmation unless `--yes` is passed. The volume is recoverable from the trash for 96 hours.

***

#### Trash management

List the volumes currently in the trash and their remaining recovery window:

```bash
verda volume trash
```

!!! danger
    After 96 hours, trashed volumes are permanently deleted and their data cannot be recovered.

***

#### Attaching volumes to instances

Volumes can be attached to instances during creation using the `verda vm create` wizard. In interactive mode, the wizard prompts you to attach existing volumes or create new ones.

For non-interactive creation, volumes are specified as part of the `verda vm create` flags.

***

#### Command aliases

The `volume` command also accepts `vol` as an alias:

```bash
verda vol list           # same as verda volume list
verda vol describe ...   # same as verda volume describe ...
```