> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ibee.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ibee.ai/docs/_mcp/server.

# Create a volume

> Provision a new NVMe block storage volume on IBEE Solutions — pick storage type, location, size, and a label.

A Block Storage volume is a persistent NVMe disk that lives independently of your servers. Once created, it can be attached to any IBEE Solutions server in the same region.

## Before you begin

* An active IBEE Solutions organization with a verified account ([Verify your account](/docs/getting-started/account-setup/verify-account))
* KYC verification completed — Block Storage requires full account verification
* Sufficient wallet credits — the platform checks your billing state before creating a volume ([Billing and usage](/docs/platform-fundamentals/billing-and-usage))

> **Warning**
>
> If your account shows a **Limited Access** banner, complete KYC verification to unlock full access to Block Storage.

## Create a volume

### Open Block Storage

In the portal sidebar, click **Block Storage** under **Products**.

If you have no volumes yet, the page shows a **No block volumes yet** empty state with an **+ Add Volume** button. Otherwise, click **+ Add Volume** in the top right.

### Choose a storage type

| Type                        | Description                                 |
| --------------------------- | ------------------------------------------- |
| **NVMe (High Performance)** | Fast block storage for production workloads |

### Choose a storage location

Select a **Storage Location** from the dropdown (e.g. `AMR 1`).

> **Info**
>
> The volume can only be attached to servers in the same region. Pick the region of the server you intend to attach to.

### Set the storage size

Use the slider, the quick-pick buttons, or **Custom GB** to enter an exact value:

| Quick picks                                   | Custom                       |
| --------------------------------------------- | ---------------------------- |
| 10 · 20 · 40 · 80 · 100 · 200 · 500 GB · 5 TB | Any value from 10 GB to 5 TB |

The summary bar updates as you change the size — e.g. **10 GB · NVMe · AMR 1** — along with the estimated monthly and hourly cost.

### Set a volume label

Enter a **Volume Label** — this is the display name for the volume in the portal and the basis for the auto-generated internal name.

* Lowercase letters, numbers, and hyphens only
* Example: `my-db-volume`, `redis-data`, `web-uploads`

### Create the volume

Click **Create Volume**. The platform first runs a billing admission check against your organization's wallet. If your balance is sufficient, the volume is created. If not, a **Billing needs attention** popup appears — click **Add Credits** to top up your wallet and return.

A toast confirms **Volume "\{label}" is being created**, then a **Volume Created** dialog appears with two actions:

* **Open Volume Details** — go straight to the volume's detail page.
* **Done** — return to the volume list.

The volume appears in the list with status **Ready** within a few seconds.

## Volume details

Click any volume in the list to open its detail page. The **Overview** tab shows:

| Field                     | Description                                                                         |
| ------------------------- | ----------------------------------------------------------------------------------- |
| **Display Name**          | The label you entered.                                                              |
| **Volume Name**           | Auto-generated internal name.                                                       |
| **Volume ID**             | Unique identifier (e.g. `69ff2c82f9850a0658962d44`).                                |
| **Internal Label**        | The label used internally.                                                          |
| **Size**                  | Provisioned capacity.                                                               |
| **Class**                 | Storage tier — `Balanced` for NVMe.                                                 |
| **Replicas**              | Number of replicas (default: `2`).                                                  |
| **Location**              | Region (e.g. `AMR 1`).                                                              |
| **Type**                  | `product`.                                                                          |
| **Created** / **Updated** | Timestamps.                                                                         |
| **Delete on Termination** | Whether the volume is deleted when its attached server is deleted. Default: **No**. |

The bottom of the page has the **Attached To** section. A new volume shows **Not attached to any server** with an **Attach to Server** button.

## Troubleshooting

**Billing needs attention popup**
Your organization's wallet balance is insufficient. Click **Add Credits** to top up, then return to create the volume.

**Limited Access banner visible**
Complete KYC verification to unlock full Block Storage access.

**Usage limit reached**
If the create form shows a **"Limit reached"** indicator, your organization has hit its block storage quota. Click the link to request an increase under **Billing → Usage Limits**.

**"Lowercase letters, numbers, and hyphens only" error**
Volume labels can't contain spaces, dots, underscores, or uppercase characters. Use a hyphen-separated lowercase name.

**Volume stuck in creating state**
Refresh the page. If the volume does not reach **Ready** within a few minutes, contact IBEE support.

## Next steps

* [Attach the volume to a server](/docs/infrastructure/block-storage/attach-and-detach-a-volume)
* [Resize a volume](/docs/infrastructure/block-storage/resize-a-volume)
* [Volume backups](/docs/infrastructure/block-storage/volume-backups)