Skip to main content
Updated May 8, 2026 Attaching a volume happens in two halves: tell Raff which VM the volume is for (dashboard side), then format and mount it inside the OS (guest side). This page covers both.

​
Before you start

  • The VM and the volume are in the same region — you can’t attach across regions
  • The VM is in active or passive state — attach works on both
  • For Linux: shell access (SSH, browser terminal, or VNC); for Windows: RDP access

​
1. Attach in the dashboard

From Compute Resources → Volumes, find the volume you want to attach. Open its row’s ⋮ Actions menu and pick Attach to VM.
Volume row Actions menu when unattached, showing Attach to VM, Configure volume, and Delete options
The Attach Volume to VM dialog asks for the target VM:
Attach Volume to VM dialog with the volume name pre-filled and a Select VM dropdown plus the active/passive requirement note
Pick a VM and click Attach. The volume’s status briefly shows Provisioning while the hypervisor wires it in (this is the normal provisioning state — the VM you attached to keeps running). Once it settles, the row shows the attached VM name:
Volumes list showing the test volume now attached to the Finance VM with a Provisioning badge
Volume row Actions menu when attached, showing Detach from VM, Increase size, Take snapshot, Configure volume, Delete
The actions menu changes when a volume is attached — Detach from VM, Increase size, and Take snapshot become available; Attach to VM disappears. The dashboard side is done. The volume now shows as a block device inside the VM, but it’s raw — no partition, no filesystem. The rest of this page covers the in-guest steps; the dashboard also has a Configure volume helper that prints the same commands ready to copy — see below.

​
1b. Use the Configure volume helper

Instead of writing the commands by hand, you can open Configure volume from the volume’s row actions menu. The dialog gives you OS-specific, copy-pasteable instructions tuned to your volume’s size, name, and chosen filesystem.
Mount Your Volume helper with Linux/Windows tabs, filesystem picker, and copy-pasteable ssh / lsblk / mkfs commands
Two tabs: Linux and Windows. Each gives you the exact steps in order:
  • Step 1: ssh username@your-vm-ip-address
  • Step 2: lsblk — find the new device (typically vdb, the next letter after the OS disk)
  • Step 3: sudo mkfs.<fs> /dev/<device> — format with the filesystem you picked at create time
After step 3 the helper shows the mount and /etc/fstab commands. The Windows tab points you at Disk Management instead. If you formatted automatically at create time, only the mount step is shown — formatting is already done. The instructions below are the manual reference for the same flow if you’d rather understand each step.

​
2. Find the new device (Linux)

SSH in and list block devices:
Look for an entry that doesn’t already have a mount point. On Raff, volumes always use the virtio-blk driver, so device names follow the /dev/vd* pattern: You won’t see /dev/sd* or /dev/nvme* paths on Raff — those are different hypervisor configurations. If lsblk shows something other than vd* for your new volume, double-check you’re inside a Raff VM. If you don’t see the new device, force a re-scan:

​
3. Format the volume (Linux)

mkfs destroys any existing data on the device. Run this only on new, empty volumes.
For most workloads, ext4 is the safe default. xfs is preferred for very large volumes (multi-TB) or workloads with many parallel writes.
The -L data sets a filesystem label you can refer to later.

​
4. Mount it (Linux)

Create a mount point and mount the volume:
Confirm:

​
5. Persist across reboots — /etc/fstab (Linux)

A mount command doesn’t survive reboot. Add an /etc/fstab entry. Get the volume’s UUID:
Add to /etc/fstab:
Notes:
  • Use UUID, not /dev/vdb — device letters can change after a hot-attach reorder.
  • nofail and x-systemd.device-timeout=10 make boot tolerant of a missing volume; without them, a detached or un-attached volume can trap the boot in emergency mode.
  • For xfs, replace ext4 with xfs.
Test the entry without rebooting:
If mount -a fails, fix the /etc/fstab line before rebooting — see Recover a locked-out VM if it’s already too late.

​
6. Format and mount on Windows

On a Windows Server VM, attach the volume in the dashboard, then:
  1. Open Server Manager → Tools → Computer Management → Disk Management.
  2. The new disk shows as Offline and Not Initialized. Right-click → Online.
  3. Right-click the disk again → Initialize Disk. Pick GPT.
  4. Right-click the unallocated space → New Simple Volume.
  5. Walk the wizard: assign a drive letter (e.g. D:), format as NTFS, give it a label.
The volume now mounts automatically across reboots — no fstab equivalent needed.

​
7. Grow a volume after resize

When you resize a volume up in the dashboard, the underlying block device grows immediately, but the filesystem doesn’t know. You need to extend it inside the VM.

​
Linux — partitioned volume

​
Linux — whole-device filesystem (no partition)

If you mkfs-ed the device directly (no partition table), there’s no growpart step:

​
Windows

In Disk Management, right-click the volume → Extend Volume and walk the wizard.

​
8. Detach safely

Before detaching, unmount cleanly so writes flush: Linux:
Windows:
  • In Disk Management, right-click the volume → Offline.
Then in the dashboard, detach the volume.

​
Quick troubleshooting

​
Next steps

Resize a volume

Grow a volume in the dashboard, then extend the filesystem.

Detach from a VM

Free a volume to reattach elsewhere.

Volume types

Performance tiers and persistence model.
Last modified on May 8, 2026