Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt

Use this file to discover all available pages before exploring further.

Updated May 10, 2026 The raff volume command group manages block storage volumes — NVMe SSD volumes you can attach to a VM, detach, resize up, and snapshot. Every subcommand supports --output json for scripting. Aliases: raff volumes, raff vol.

Subcommand index

SubcommandWhat it does
listList volumes in the project
getShow details for one volume
createCreate a new volume
deleteDelete a volume
resizeGrow a volume
attachAttach a volume to a VM
detachDetach a volume from its VM

list

raff volume list [--region <region>] [--vm-id <vm-uuid>] [--output table|json]
List volumes in the current project. Output columns: ID, NAME, SIZE, TYPE, STATUS, REGION, ATTACHED VM.
raff volume list
raff volume list --vm-id <vm-uuid>
raff volume list --output json | jq '.[] | {id, name, status}'

get

raff volume get <volume-id> [--output table|json]
Show full details for one volume — size, type, status, region, attached VM (if any).

create

raff volume create \
  --name <name> \
  --size <gb> \
  --type nvme \
  [--region <region>] \
  [--filesystem ext4|xfs|btrfs] \
  [--vm-id <vm-uuid>]
Create a volume. Required: --name, --size, --type. Pass --vm-id to attach at create time — the VM must be in the same region. --filesystem is the filesystem laid down on first attach (Linux only); defaults to ext4.
# Standalone — attach later
raff volume create --name data-01 --size 100 --type nvme --region us-east

# Create and attach to a VM
raff volume create --name data-01 --size 100 --type nvme \
  --region us-east --vm-id <vm-uuid>

delete

raff volume delete <volume-id> [--force]
Delete a volume. Pass --force to skip the confirmation prompt — required in scripts. Detach the volume first if it’s still attached.

resize

raff volume resize <volume-id> --new-size <gb>
Grow a volume. The new size must be larger than the current size — volumes cannot shrink. Filesystem expansion inside the guest is not automatic; see Resize a volume for the growpart / resize2fs steps.

attach

raff volume attach <volume-id> --vm-id <vm-uuid>
Attach a volume to a VM. Volume and VM must be in the same region. Inside the guest, attached volumes appear as /dev/vdb, /dev/vdc, etc. (/dev/vda is the OS disk).

detach

raff volume detach <volume-id>
Detach the volume from its current VM. The volume remains in the project and can be reattached later.

Snapshot commands

Capture a point-in-time snapshot of a volume.

raff_volume (Terraform)

Declarative volume management.

API Reference

The HTTP API behind the CLI.
Last modified on May 11, 2026