> 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.

# Cloud VM

> Deploy a cloud virtual machine on IBEE Solutions in minutes — choose your region, location, plan, OS, and hostname, then click Deploy Now to provision your server.

Deploy a cloud virtual machine (VM) from the IBEE Solutions console. Choose your region, location, plan, operating system, and hostname, then click **Deploy Now** to provision your server.

## Before you begin

* An active IBEE Solutions account
* A verified account to unlock server deployment ([Verify your account](/docs/getting-started/account-setup/verify-account))
* Sufficient wallet credits — the platform checks your balance before deploying ([Billing and usage](/docs/platform-fundamentals/billing-and-usage))

## Deploying Cloud VM Instance

### 1. Select Region

On the Create VM page, select a region tab.

**Available region:** Asia

### 2. Select Location

Choose a data center location within your selected region.

| Region | Location         | Country |
| ------ | ---------------- | ------- |
| Asia   | Amaravati (VGA)  | India   |
| Asia   | Hyderabad (HYD1) | India   |

See [Regions and locations](/docs/getting-started/overview/regions-and-locations) for details on availability.

### 3. Select Plan

Choose a plan based on your compute requirements (CPU, RAM, storage). The estimated monthly and hourly cost is shown as you select a plan.

### 4. Select OS

Pick a source for the boot disk under **Operating System**:

| Tab           | Use it for                                                         |
| ------------- | ------------------------------------------------------------------ |
| **Templates** | Curated, official OS images maintained by IBEE. The default.       |
| **ISOs**      | Boot from a public or uploaded ISO and run an interactive install. |
| **Snapshots** | Restore a manual recovery point captured from another VM.          |
| **Backups**   | Restore from a scheduled backup recovery point.                    |

The available OS images are filtered based on the VM type (Cloud VM vs GPU VM) to show only compatible templates.

For a clean install, stay on **Templates** and pick an OS family card:

#### Windows

#### AlmaLinux

#### Rocky

#### Fedora

#### Debian

#### Ubuntu

#### Windows Standard

The selected card highlights in orange with a check mark.

For ISOs, snapshots, or backups as the source, see [Custom images](/docs/infrastructure/cloud-vms/custom-images).

### 5. Select OS Version

Choose a version from the **OS Version** dropdown. The list is filtered to the OS family you picked.

Examples:

* `Ubuntu 24.04`
* `AlmaLinux 9`
* `Debian 12`
* `Rocky 9`
* `Fedora 40`
* `Windows Server 2022`

A confirmation chip — **Selected: \<version>** with the OS icon — appears below the dropdown. The same chip is mirrored in the bottom bar (for example `AlmaLinux 9`) so you can verify the selection while scrolling.

### 6. Enter Hostname

Enter a unique name to identify your server (required).

Example: `my-server-01`

### 7. Deploy

Click **Deploy Now** in the bottom bar. The platform first checks your organization's billing state and wallet balance against the plan's cost. If credits are sufficient, your server begins provisioning. If not, a **Billing needs attention** popup appears — click **Add Credits** to top up and return.

## Verify

Once provisioned, your server appears in the server list with a running status. Click it to open the server detail page.

The VM detail page shows your server's configuration, public IP, and attached SSH key names.

## Launch with the ibee CLI

Prefer the terminal? Use the [`ibee`](/docs/infrastructure/cloud-vms/launch-your-first-vm#using-the-ibee-cli) CLI to script VM creation.

```bash
# Authenticate and select a workspace
export IBEE_TOKEN="ibee_prod_key_xxxxxxxxxxxx"
export IBEE_WORKSPACE_ID="WORKSPACE_ID"

# Launch a VM
ibee vms create web-01 \
  --site-id SITE_ID \
  --plan-id PLAN_ID \
  --template-id IMAGE_ID \
  --ssh-key-id SSH_KEY_ID \
  --wait
```

The `--wait` flag polls the asynchronous create operation until it finishes.
Drop it to receive the operation immediately and poll it later with
`ibee ops get <operation-id> --wait`.

### Common flags

| Argument or flag    | Purpose                                                      |
| ------------------- | ------------------------------------------------------------ |
| `NAME`              | VM display name (required positional argument).              |
| `--site-id`         | Optional placement site ID; omit it for automatic placement. |
| `--plan-id`         | Plan ID returned by `ibee compute plans` (required).         |
| `--template-id`     | Image ID returned by `ibee compute images` (required).       |
| `--os-distro`       | OS distribution; defaults to `ubuntu`.                       |
| `--os-type`         | OS family; defaults to `linux`.                              |
| `--cpu`, `--ram-mb` | Fallback compute fields accepted by the API.                 |
| `--disk-gb`         | Optional root-disk size.                                     |
| `--ssh-key-id`      | Existing SSH key ID; repeat for multiple keys.               |
| `--tag`             | Resource tag; repeat for multiple tags.                      |
| `--wait`            | Poll the asynchronous create operation until completion.     |

### Discover available sites, plans, and images

```bash
ibee compute sites
ibee compute plans --vm-type cloud --site-id SITE_ID
ibee compute images --vm-type cloud --site-id SITE_ID
```

For the full quickstart and CLI reference, see [Launch your first VM](/docs/infrastructure/cloud-vms/launch-your-first-vm).

## Manage your VM

From the server detail page, use **Actions** to control your server:

| Action | Description                                           |
| ------ | ----------------------------------------------------- |
| Start  | Power on a stopped server                             |
| Stop   | Gracefully shut down a running server                 |
| Reboot | Restart the server                                    |
| Delete | Permanently delete the server — this cannot be undone |

> **Warning**
>
> Deleting a VM is permanent and cannot be undone. Back up your data before
> deleting.

## Troubleshooting

**Deploy Now button is disabled**
Ensure all required fields are filled — Region, Location, Plan, OS, OS Version, and Hostname are all required before deploying.

**Billing needs attention popup appears**
Your organization's wallet balance is insufficient for the selected plan. Click **Add Credits** to top up, then return to deploy.

**Server stuck in provisioning**
Wait a few minutes. If the status does not update, contact IBEE support.

**Hostname rejected**
Ensure the hostname contains only alphanumeric characters and hyphens (e.g. `my-server-01`).

## Related pages

* [Add SSH keys](/docs/tools/ssh-keys)
* [Take a snapshot](/docs/tools/snapshots/create-a-snapshot)
* [Attach block storage](/docs/infrastructure/block-storage/attach-and-detach-a-volume)
* [Delete a VM](/docs/infrastructure/cloud-vms/power-actions)