Attach volumes
Attach a Block Storage volume to a Cloud VM when you need persistent storage that survives plan changes, OS rebuilds, and VM deletion. Volumes attach as additional disks (vdb, vdc, …) alongside the root disk (vda).
When to use a separate volume
- Your data should outlive the VM (databases, file servers, user uploads).
- You want to grow capacity independently of CPU and RAM.
- You need to move data between VMs (detach from one, attach to another).
- You want snapshot scope flexibility — capture data volumes selectively (Selective volumes capture mode).
For ephemeral data that lives and dies with the VM, the included root disk on each instance type is fine.
Attach a volume
1. Create the volume
If you don’t already have one, create a volume in the same region as the VM. See Create a volume.
Mount the volume inside the guest (Linux)
Use the platform’s mount instructions, or follow these standard steps the first time you attach a fresh volume.
Use UUID-based fstab entries. Device names like /dev/vdb can change after detach/reattach or restore. Mounting by UUID keeps the path stable.
The IBEE portal surfaces these exact steps in Snapshots → Recovery Point Details → Mount Instructions after a restore, including the device path, suggested mount point, and the four-step sequence above.
Mount the volume inside the guest (Windows)
- Open Disk Management.
- Bring the new disk Online and Initialize it (GPT for >2 TB).
- Right-click the unallocated space → New Simple Volume and follow the wizard.
- Assign a drive letter and format as NTFS.
Detach a volume
- Unmount inside the guest first (
sudo umount /mnt/volume_<id>) to avoid filesystem corruption. - From the volume or VM page, click Detach.
- The activity feed shows
VM detach_volume operation accepted→completed.
A detached volume keeps its data and can be reattached to any VM in the same region.
Volumes and snapshots
When you take a snapshot, you choose the Capture Mode:
After restore, captured data volumes are auto-attached to the target VM. Mount instructions are surfaced in the snapshot detail view. See Create a snapshot.
Troubleshooting
lsblk doesn’t show the new device
Wait 10–20 seconds after the activity feed reports completion, then rerun. If it still doesn’t appear, reboot the VM.
mount fails with “wrong fs type”
The volume isn’t formatted yet. Run sudo mkfs.ext4 /dev/vdX on the first attach only.
Volume is read-only after restore The platform restores the volume but doesn’t auto-mount it inside the guest. Open Snapshots → Recovery Point Details → View instructions for the exact mount command for that volume.
