StorageBlock Storage

Attach and detach a volume

Attaching a volume connects it to a server so the OS can see it as a disk device. After attaching, you mount it using the commands in the Mount Instructions tab.

Before you begin

  • A Ready block storage volume (Create a volume)
  • A running IBEE Cloud server to attach it to

Attach a volume

1

Open the volume

In the portal, go to Block Storage and click the volume you want to attach.

2

Attach to a server

On the Overview tab, find the Attached To section. Click Attach.

3

Select a server

In the Attach Volume modal, select the target server from the Server dropdown, then click Attach.

After attaching, return to the volume detail page and open the Mount Instructions tab. The device path (e.g. /dev/vdc) will appear there once the attachment is complete.

Mount the volume (Linux)

After attaching, open the Mount Instructions tab on the volume detail page and run the following commands on your server:

$# 1. Check the disk is visible
$lsblk
$
$# 2. Format — FIRST TIME ONLY, skip if the volume already has data
$sudo mkfs.ext4 /dev/<guest-disk>
$
$# 3. Create a mount point
$sudo mkdir -p /mnt/data
$
$# 4. Mount the volume
$sudo mount /dev/<guest-disk> /mnt/data
$
$# 5. Verify
$df -h /mnt/data
$
$# 6. Make the mount persistent across reboots
$UUID=$(sudo blkid -s UUID -o value /dev/<guest-disk>)
$echo "UUID=$UUID /mnt/data ext4 defaults,nofail 0 2" | sudo tee -a /etc/fstab

Replace /dev/<guest-disk> with the actual device path shown in the Mount Instructions tab (e.g. /dev/vdc).

Only run the mkfs.ext4 format command on a new, empty volume. Running it on a volume with existing data will erase all data.

Detach a volume

Unmount the volume at the OS level before detaching from the portal to avoid data corruption.

1

Unmount the volume on the server

SSH into the server and unmount the volume:

$sudo umount /mnt/data

If you added an entry to /etc/fstab, remove or comment it out to prevent mount errors on reboot.

2

Detach in the portal

Open the volume detail page. On the Overview tab, click Detach next to the attached server.

After detaching, the volume status returns to Not attached and can be re-attached to any other server.

Troubleshooting

Device path not shown in Mount Instructions The device path only appears after the volume is fully attached. Wait a few seconds and refresh the page.

lsblk does not show the new disk Ensure the attach completed successfully in the portal. If the volume shows as attached but the disk is not visible, try rebooting the server.

Mount does not persist after reboot Ensure step 6 (fstab entry) was run correctly. Verify the UUID is correct with sudo blkid /dev/<guest-disk>.

Detach fails in portal Unmount the volume at the OS level first (sudo umount /mnt/data) before detaching in the portal.