For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LoginGet Started
DocsAPI ReferenceChangelog
DocsAPI ReferenceChangelog
    • Home
  • Getting Started
  • Infrastructure
    • GPU VMs
    • Cloud VMs
    • Object Storage
    • Block Storage
  • Network & Security
    • Load Balancer
    • DNS
    • CDN
    • Firewalls
    • SSL Certificates
  • Tools
    • Backups
    • Snapshots
    • ISOs
    • SSH Keys
    • API Tokens
    • Secret Manager
    • Container Registry
  • Platform Fundamentals
    • Projects and tenancy model
    • IAM
    • Networking overview
    • Billing and usage
    • Limits and quotas
    • SLA and reliability
  • Tutorials
    • Deploy a web app
    • Host a static website with object storage
    • Run an AI model on a GPU VM
    • Set up a load-balanced architecture
    • Backup and disaster recovery
    • Multi-region deployment
  • Migration Guides
    • Migrate from AWS
    • Migrate from GCP
    • Migrate from Vultr and Linode
    • Move S3 workloads to IBEE Object Storage
    • VM image migration
  • Reference
    • Pricing
    • Regions
    • Limits
    • Error codes
    • Service level agreement
  • Support
    • Contact Support
    • Create a request
    • Troubleshooting guides
    • Visit ibee.ai
LogoLogo
LoginGet Started
On this page
  • Open the ISOs page
  • Add an ISO
  • Boot a VM from your ISO
  • Manage ISOs
  • Bring-your-own-image checklist
  • Troubleshooting
  • Related pages
Tools

ISOs

Was this page helpful?
Edit this page
Previous

SSH Keys

Next
Built with

ISOs let you install operating systems that aren’t in the OS template catalog. Upload an ISO once at the project level, then choose it under Operating System → ISOs when creating a VM.

Open the ISOs page

  1. In the IBEE Cloud portal, expand Tools in the left nav.
  2. Click ISOs.

The page lists every ISO in the current project, with a Search ISOs… box and a Refresh button. The empty state shows No ISOs Found with an Add ISO call-to-action.

Add an ISO

1

1. Click Add ISO

Click Add ISO (top-right or the empty-state button). The ADD ISO dialog opens with the subtitle Upload from a remote URL (up to 10 GB).

2

2. Enter a name

In ISO NAME, give the image a clear, human-readable label.

Example: Ubuntu 24.04 LTS

This is the name you’ll see in the ISOs list and in the VM deployer’s ISOs tab.

3

3. Paste a remote URL

In REMOTE URL, paste the public URL where the ISO can be downloaded.

Example: https://releases.ubuntu.com/24.04/ubuntu-24.04.iso

4

4. Confirm the constraints

The dialog reminds you of the upload requirements:

ConstraintValue
ISO must be publicly accessible via the URLYes — IBEE pulls from the URL you provide
Supported formats.iso images only
Maximum size10 GB
URL schemeMust begin with http:// or https://

If your image lives behind authentication, host it on a public bucket (such as Object Storage) or generate a signed URL that doesn’t require headers.

5

5. Click Add ISO

Click Add ISO in the bottom-right of the dialog. IBEE downloads the ISO from the URL into project storage. The new entry appears in the list once the download completes.

Boot a VM from your ISO

  1. Open Cloud VMs → Create server.
  2. Pick Region, Location, and Plan as usual.
  3. Under Operating System, switch to the ISOs tab.
  4. Pick your uploaded ISO from the list.
  5. Continue with SSH Keys, Hostname, and Deploy Now.

The VM boots from the ISO. Open the Console to step through the installer, partition the root disk, and finish the install.

Manage ISOs

From the ISOs list:

  • Use the search box to filter by name or ID.
  • Use Refresh to re-poll the catalog after a recent upload.
  • Use the per-row actions menu to delete an ISO you no longer need.

Deleting an ISO removes it from project storage. VMs already installed from the ISO are unaffected — the install lives on the VM’s own root disk.

Bring-your-own-image checklist

For a custom Linux ISO to boot cleanly under KVM, verify before uploading:

  • virtio drivers for disk and network are present (Linux kernels include them by default).
  • DHCP client is enabled on the primary NIC.
  • The ISO has a working bootloader that targets /dev/vda.
  • (Optional) Install cloud-init during the install for SSH key injection on next boot.

For Windows ISOs, plan to install virtio drivers from the Windows guest tools ISO during setup.

Troubleshooting

Add ISO button is disabled Both ISO NAME and REMOTE URL are required. The URL must start with http:// or https://.

Download fails or stalls The URL must be publicly reachable from IBEE infrastructure. Check the URL in a browser; if it requires authentication, redirects to a login page, or rate-limits unauthenticated downloads, host the ISO somewhere that doesn’t.

Image rejected as “unsupported format” Only .iso files are accepted. Cloud images in .qcow2, .img, or .vmdk are not — for those, see Custom images (snapshot/backup paths instead).

ISO won’t boot Open the Console and watch the boot output. Most failures are missing virtio drivers or a bootloader pointing at the wrong device.

Related pages

  • OS images
  • Custom images
  • Create a VM
  • Console access