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 8, 2026 Volumes are NVMe SSD block storage you attach to a Raff VM as additional disk capacity. Use them when a VM needs more storage than its plan includes, or — more importantly — when you want data to outlive the VM itself. Volumes survive VM destroy, attach to a different VM, and bill independently.
Storage Volumes list in the Raff dashboard showing an attached volume "test" mapped to the Finance VM with a Provisioning badge

At a glance

PropertyValue
Storage classSingle tier — NVMe SSD (no tiers to choose)
Size range10 — 1000 GiB at create time
ResizeOne-way grow — capacity increases only
AttachOne VM at a time; reattach to a different VM in the same region
Survives VM destroyYes — detached, kept in the account, ready to reattach
FilesystemsLinux: ext4 / xfs (auto-format option). Windows: NTFS (manual via Disk Management)
Device naming/dev/vdb, /dev/vdc, … (virtio-blk; never sd* or nvme*)
BillingSubscription default $0.05/GiB/month (PAYG on request, same rate)
Bandwidth between VM and volumeFree, never metered

When to use a volume

GoalUse a volume?Use what instead
Add disk to one VM beyond the plan’s base NVMe SSDYes
Keep data when destroying a VM (databases, customer uploads, app state)Yes
Move data between VMs serially (detach → attach to another)Yes
Two VMs reading the same files at onceNo — single-attachObject Storage
Files served to the public (static assets, downloads)NoObject Storage
One-off snapshot before risky changesNo (snapshots are a separate object)Snapshots
Reusable disk image for many new VMsNoCustom images
If you’re hesitating between volumes and Object Storage: volumes are block devices (a single VM mounts them like a disk); Object Storage is HTTP-accessible (many clients can read/write at once, scales beyond 1 TB, served over a URL).

How volumes fit in the storage stack

A Raff VM has up to five storage objects in its orbit. Volumes are one of them:
Storage objectLivesSurvives VM destroyBest for
Base disk (in the plan)Inside the VMNo — destroyed with VMOS, transient working files
VolumesAttached to one VMYes — keptData you can’t afford to lose with the VM
SnapshotsIndependent of the VMVM-disk snapshots: deleted with VM. Volume snapshots: surviveRestore points before risky changes
BackupsIndependentYes (per retention)Routine scheduled VM protection
Custom imagesAccount-wideYesGolden images for new VMs
See Storage model for the full survival matrix and decision flowchart across every lifecycle event.

Most viewed

Create a volume

Pick size, billing term, target VM, and how it should be formatted.

Attach to a VM

Dashboard attach + format and mount inside the VM.

Resize a volume

Grow capacity, then expand the filesystem inside the guest.

Detach from a VM

Free a volume cleanly so you can reattach it elsewhere.

Browse

Quickstart & guides

Create, attach, resize, detach, delete.

Concepts

Persistence model and single-attach scope.

Details

Features, limits, pricing.

Troubleshooting

Common volume issues — attach, mount, resize, detach.

API Reference

Volume endpoints.

Changelog

All API updates and changes.
Last modified on May 8, 2026