Skip to navigation

OS images

An OS image (the portal calls it a template) is a ready-made copy of an operating system, such as Ubuntu 24.04 or Windows. When you create a VM, IBEE copies the image onto the VM’s root disk and boots it. Templates are maintained by IBEE; you can also start a VM from a snapshot or backup of one of your VMs. ISOs aren’t available yet.

When to use each source

The Operating System section of the Deploy page has four tabs:

TabUse it whenNotes
Templates (default)You want a clean, current operating systemThe usual choice. Only images that work on Cloud VMs are listed (GPU images appear on the GPU VM Deploy page).
SnapshotsYou want a copy of a VM you already set upSee Custom images.
BackupsYou want to rebuild a VM from a scheduled backupOnly the root disk is used.
ISOsThe operating system you need isn’t in the templatesNot available. The ISO service isn’t running, so the tab shows “No ISOs available for this account.” Use a template, or a snapshot of a VM you’ve set up. See ISOs.

How it works

  1. You pick a template, for example Ubuntu → Ubuntu 24.04.
  2. IBEE copies it to the new VM’s root disk.
  3. At first boot, a setup tool inside the image called cloud-init reads the settings IBEE prepared — hostname, user, SSH keys, network — and applies them.
  4. The VM shows Running, and Overview → Connection Details shows how to sign in.

Before you begin

  • Know whether you need Linux (most web servers, databases, containers) or Windows (software that needs Windows, or Remote Desktop users).
  • For Linux, have an SSH key ready. It’s safer than a password.
  • For Windows, expect a licence charge per vCPU, shown on the Deploy page.

Choose an image

1

Open the Operating System section

On the Deploy page (Infrastructure → Cloud VMs → Deploy VM), scroll to Operating System. Templates is selected.

2

Pick a family and version

Click a family card, such as Ubuntu or Windows. The families and versions offered depend on the location; the cards show what’s available. Then choose a version from OS Version. A Selected: <version> chip confirms it.

3

Check the licence (Windows only)

For Windows, Licences & control panels adds the Windows licence automatically, marked Required for the selected Windows image, with its monthly price.

To list images with the CLI, run ibee compute images --vm-type cloud --site-id SITE_ID. The API equivalent is GET /compute/images?vm_type=cloud&workspace_id=..., which returns each image’s template_id, name, os_distro and os_type.

What IBEE sets up at first boot (Linux)

SettingWhat you get
UserA user named after the distribution (for example ubuntu), with sudo rights and no sudo password
Sign-in with an SSH keyYour keys are installed for that user, and password sign-in over SSH is turned off.
Sign-in without a keyA generated password is set for the user and password sign-in is turned on
HostnameThe hostname you entered on the Deploy page
NetworkThe VM’s IP address, gateway and DNS servers are written into the network settings. If no DNS servers are given, 1.1.1.1 and 8.8.8.8 are used.
Guest agentqemu-guest-agent is installed and started. IBEE uses it for disk-usage charts and password resets.
Disk sizeThe root partition grows to fill the disk at every boot, including after a resize
UpdatesPackages are not upgraded at first boot. Run sudo apt update && sudo apt upgrade (or sudo dnf upgrade) yourself.

Default username and password

Open the VM, then Overview → Connection Details:

VMUsernameHow you sign in
Linux, created with an SSH keyThe distribution name, for example ubuntuSSH Key Connection: ssh -i <your-key> ubuntu@<ip>
Linux, created without a keyThe distribution nameSSH Connection: username, host and password
WindowsAdministratorRemote Desktop (RDP): IP address, username and password, on port 3389

Passwords are shown only to members with write access, and only while the VM is running. Use the eye icon to show a password and the copy button to copy it.

To change access later on a Linux VM, open Settings → Access: add or remove SSH keys, turn Password Login on or off, or Reset Password. The VM must be running. On Windows, change passwords inside Windows. See Change access on an existing VM.

Changing the operating system

You can’t change the OS of an existing VM yet: Settings → Change OS says “This section is under development.” To move to another OS, create a new VM with the image you want, copy your data across, and delete the old VM. Keep data on a Block Storage volume to move it between VMs easily.

Limits

Value
Images per VM1, chosen at creation
Root disk the image is copied to50 GB to 400 GB, set by the plan
Windows licenceCharged per vCPU, for as long as the VM exists; Remote Desktop on TCP port 3389
Linux sign-inSSH on TCP port 22
Password visibilityWrite access only, while the VM is running
Change OS in placeNot available

Troubleshooting

You seeWhat it meansWhat to do
Please select an Operating System versionYou picked a family but no versionChoose a version from OS Version.
Failed to load operating systemsThe image list didn’t loadReload the page. If it keeps failing, pick another location or contact support.
Permission denied (publickey)Wrong username, or the key isn’t on the VMCopy the username from Connection Details (it isn’t root). Add a key under Settings → Access.
The SSH section isn’t on the Deploy pageYou picked a Windows imageWindows uses a password and Remote Desktop.
No password under Connection DetailsThe VM uses an SSH key, the VM is stopped, or you have read-only accessUse your key, start the VM, or ask for write access.
The image you want isn’t listedIt isn’t offered in this location, or it isn’t a Cloud VM imagePick another location, or use Custom images.