---
url: https://ibee.ai/docs/tools/isos
last_updated: 2026-10-19
---

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

# ISOs

> An ISO is an installer disk image, such as an operating system installer, that you add to IBEE from a public URL. What the ISOs page does, its limits, and what to use while ISO uploads are unavailable.

An **ISO** is a single file that holds a complete installer disk, the same thing you would burn to a DVD or write to a USB stick, for example `ubuntu-24.04-live-server-amd64.iso`. The ISOs page lets you add one from a public web address so you could install an operating system that isn't in IBEE's image list.

> **Warning**
>
> **ISOs are not available right now.** The ISOs page appears in the portal, but the service behind it isn't running: the list always shows **No ISOs Found**, **Add ISO** shows an error, and a VM can't boot from an ISO. Use an [OS image](/docs/infrastructure/cloud-vms/os-images) or a [snapshot](/docs/tools/snapshots) instead. To ask when ISOs will be available, [contact support](/docs/support/contact-support).

## Choose what to start a VM from

| You want to…                                       | Use                                                                          | Available now?                                                                                 |
| -------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Start a VM with a standard Linux or Windows system | An [OS image](/docs/infrastructure/cloud-vms/os-images) from the deploy form | Yes                                                                                            |
| Start many VMs that match one you already set up   | A [snapshot](/docs/tools/snapshots) of that VM                               | Yes                                                                                            |
| Bring your own disk image                          | See [Custom images](/docs/infrastructure/cloud-vms/custom-images)            | See that page                                                                                  |
| Run an operating system installer step by step     | An **ISO**                                                                   | No: ISOs aren't available, and the browser console an installer needs is still **Coming soon** |

## How it is meant to work

1. You give IBEE a name and a public `http://` or `https://` URL of an `.iso` file.
2. IBEE downloads and checks the file. Its status moves from **Pending** to **Complete**, or to **Error** if the download fails.
3. You pick the ISO under **Operating System → ISOs** when you deploy a VM.
4. You step through the installer in the VM's console.

## Before you begin

* An organization you belong to. ISOs belong to the **organization**, not to one workspace.
* An `.iso` file that anyone can download from a public URL, without signing in.
* For step 4, a browser console for the VM. The VM console still shows **Coming soon**.

## Add an ISO

These are the portal's steps. While ISOs are unavailable, the last step shows an error.

### Open ISOs

Open a workspace. In the sidebar, under **Tools**, click **ISOs**.

### Start adding

Click **Add ISO**. The **Add ISO** dialog opens with the note **Upload from a remote URL (up to 10 GB)**.

### Enter a name

In **ISO Name**, enter a label you will recognize, for example `Ubuntu 24.04 LTS`.

### Enter the URL

In **Remote URL**, paste the public download address, for example `https://releases.ubuntu.com/24.04/ubuntu-24.04.3-live-server-amd64.iso`.

### Add it

Click **Add ISO**. When the service is working, the portal shows "ISO added — validating URL in background…" and the ISO appears with status **Pending**.

## What the ISOs page shows

| Column          | What it shows                                                              |
| --------------- | -------------------------------------------------------------------------- |
| **ISO**         | The name you gave it                                                       |
| **Status**      | **Pending** (downloading and checking), **Complete** (ready), or **Error** |
| **Size**        | The file size once downloaded                                              |
| **MD5**         | A checksum you can compare with the publisher's value                      |
| **Attached To** | The VM it is attached to, or **Not attached**                              |
| **Added**       | The date it was added                                                      |

The row menu offers:

* **Attach**: for a **Complete** ISO that isn't attached. Enter the **VM ID** (and, optionally, a **VM Name**) and click **Attach**. This only records the VM next to the ISO; it doesn't change how the VM starts.
* **Detach**: confirm with **Detach ISO**.
* **Delete**: type the ISO's name to confirm, then click **Delete ISO**. An attached ISO must be detached first.

## Limits

|              | Value                                                                          |
| ------------ | ------------------------------------------------------------------------------ |
| File size    | Up to 10 GB, as stated in the **Add ISO** dialog                               |
| File type    | `.iso` images                                                                  |
| URL          | Must start with `http://` or `https://` and be downloadable without signing in |
| VMs per ISO  | 1 at a time                                                                    |
| List refresh | Every 5 seconds while an ISO is **Pending**, or click **Refresh**              |

## Troubleshooting

| You see                                            | What it means                                         | What to do                                                                                         |
| -------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **No ISOs Found**, even after adding one           | The ISO service isn't available                       | Use an [OS image](/docs/infrastructure/cloud-vms/os-images) or a [snapshot](/docs/tools/snapshots) |
| An error after clicking **Add ISO**                | The ISO service isn't available                       | As above                                                                                           |
| "Remote URL is required" or "ISO name is required" | A field is empty                                      | Fill in both fields                                                                                |
| "URL must start with http\:// or https\://"        | The address isn't a web URL                           | Paste the full download link                                                                       |
| **Attach** isn't in the row menu                   | The ISO isn't **Complete**, or it is already attached | Wait for **Complete**, or detach it first                                                          |
| "Detach this ISO from its VM before deleting."     | The ISO is attached                                   | Click **Detach**, then **Delete**                                                                  |

## Related pages

* [OS images](/docs/infrastructure/cloud-vms/os-images): the operating systems you can deploy today
* [Snapshots](/docs/tools/snapshots): copy a VM you already set up
* [Custom images](/docs/infrastructure/cloud-vms/custom-images)
* [Create a VM](/docs/infrastructure/cloud-vms/create-a-vm)