> For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://ibee.ai/docs/llms.txt (full text of every page: https://ibee.ai/docs/llms-full.txt). For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ibee.ai/docs/_mcp/server. # Block Storage > IBEE Block Storage volumes are extra NVMe disks you attach to a Cloud VM or GPU VM. When to use them, sizes (10–2,000 GB), billing while detached, performance, and the create → attach → mount workflow. A Block Storage **volume** is an extra disk that you attach to a Cloud VM or GPU VM. Inside the VM it looks like a new, empty drive (for example `/dev/vdb`): you format it once, mount it, and use it like any local disk. The volume lives separately from the VM, so its data stays when you detach it, attach it to another VM in the same location, or delete the VM. ## When to use Block Storage | You want to… | Use | Why | | ------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | Give a database or app more disk space than the VM came with | **Block Storage** | Add 10–2,000 GB without changing the VM's plan | | Keep data when you rebuild or replace a VM | **Block Storage** | Detach the volume and attach it to the new VM | | Store files that many servers or users read over the internet | [**Object Storage**](/docs/infrastructure/object-storage) | Any number of files over HTTPS, billed for what you store | | Share one disk between several VMs at once | Not supported | A volume attaches to one VM at a time. Use Object Storage or a file server on a VM. | | Store container images | [**Container Registry**](/docs/infrastructure/container-registry) | Docker clients push and pull directly | ## How it works 1. **Create** a volume in the same location as your VM and choose its size. It shows **Ready**. 2. **Attach** it to a VM in the portal. Its status becomes **In Use** and the portal shows the device path. 3. **Format and mount** it inside the VM — once for a new volume — using the commands on the volume's **Mount Instructions** tab. 4. **Unmount, detach and delete** it when you no longer need it. ## Before you begin * An IBEE organization with **identity verification** completed. See [Verify your identity](/docs/getting-started/account-setup/verify-your-identity). * Wallet credit: the portal checks your billing before it creates a volume. See [Add billing](/docs/getting-started/account-setup/add-billing). * A [Cloud VM](/docs/infrastructure/cloud-vms) or GPU VM in the location where you'll create the volume, and SSH (Linux) or Remote Desktop (Windows) access to it. ## Get started ### Create a volume Open **Infrastructure → Block Storage**, click **+ Add Volume**, pick your VM's **Location**, a size and a name, and click **Create Volume**. See [Create a volume](/docs/infrastructure/block-storage/create-a-volume). ### Attach it to a VM Open the volume and click **Attach to Server**. See [Attach and detach a volume](/docs/infrastructure/block-storage/attach-and-detach-a-volume). ### Format and mount it Run the commands from the **Mount Instructions** tab inside the VM. ## Key facts and limits | Question | Answer | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Size range | 10 GB to 2,000 GB in the portal (the storage plan for the site sets the exact range) | | Grow or shrink? | Grow only. A volume can't be made smaller. | | Storage type | **NVMe SSD** | | Performance | Up to 500 GB: **Standard**, about 5,000 shared IOPS and 125 MiB/s. Above 500 GB: **High Performance**, about 10,000 shared IOPS and 400 MiB/s. The portal shows the figures for your plan. | | Copies kept | 2 replicas by default | | Location | A volume attaches only to VMs in its own location | | VMs per volume | 1 at a time | | Formatted when created? | No. A new volume is a blank disk: you format it once inside the VM. | | Billed while detached? | Yes. A volume is billed for its full size from creation until you delete it, attached or not. | | Deleted with the VM? | No. Volumes stay when the VM they're attached to is deleted. | IOPS means input/output operations per second: how many small reads and writes the disk handles each second. "Shared" means the figure is a ceiling, not a guarantee. ## Billing Volumes are billed per GB of provisioned size per month, from creation until deletion. The create page shows the per-GB rate and the estimated monthly and hourly cost before you click **Create Volume**. Detaching a volume, or stopping its VM, does not stop the charge: delete the volume to stop it. ## Troubleshooting | You see | What it means | What to do | | ------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | The VM's disk is still full after you attached a volume | A volume is a separate disk; nothing moves to it automatically | Mount the volume (for example on `/mnt/data`) and move or write data there. | | A resized volume still shows the old size inside the VM | The file system wasn't expanded | Run the commands in [Expand the file system](/docs/infrastructure/block-storage/create-a-volume#expand-the-file-system). | | Your VM isn't in the **Attach Volume** list | The VM is in a different location | Create the volume in the VM's location. | | *Detach this volume from all servers before deleting.* | The volume is still attached | [Detach it](/docs/infrastructure/block-storage/attach-and-detach-a-volume#detach-a-volume) first. | | **Limit reached (X%) — Increase** on the create page | Your organization reached its Block Storage usage limit | Click it, then **Raise a support ticket** on the usage-limits page. | ## Related pages * [Create a volume](/docs/infrastructure/block-storage/create-a-volume): create, resize and delete * [Attach and detach a volume](/docs/infrastructure/block-storage/attach-and-detach-a-volume): attach, mount, unmount, detach * [Cloud VMs](/docs/infrastructure/cloud-vms) * [Snapshots](/docs/tools/snapshots) * [Object Storage](/docs/infrastructure/object-storage) ## Docs - [Create a volume](https://ibee.ai/docs/infrastructure/block-storage/create-a-volume.md): Create an IBEE Block Storage volume — choose the site, size (10–2,000 GB) and name, see the price, then resize it (grow only) or delete it. Portal steps and the public API. - [Attach and detach a volume](https://ibee.ai/docs/infrastructure/block-storage/attach-and-detach-a-volume.md): Attach an IBEE Block Storage volume to a Cloud VM or GPU VM, format and mount it on Linux or Windows, keep it mounted after reboots, then unmount and detach it safely.