Skip to content

Documentation for Multiple CD-ROM / ISO Support Per VM feature #648

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Damans227 wants to merge 3 commits into
base: main
Choose a base branch
from
+40 −1
Open

Documentation for Multiple CD-ROM / ISO Support Per VM feature #648

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4817244
Add support for multiple attached ISOs per Instance in templates docu…
Damans227 May 4, 2026
3764308
Clarify multi-ISO attachment limits and behavior in Instance document…
Damans227 May 5, 2026
f4eb687
Clarify terminology for ISO attachment limits in Templates documentation
Damans227 May 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 40 additions & 1 deletion source/adminguide/templates.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -447,6 +447,16 @@ can also attach ISO images to Guest Instances. For example, this enables
installing PV drivers into Windows. ISO images are not
hypervisor-specific.

A single Instance can hold more than one attached ISO simultaneously, with
each ISO appearing as its own CD-ROM drive inside the guest. This is useful,
for example, when installing Windows on a KVM Instance that uses VirtIO disks
- the Windows installer ISO and the VirtIO drivers ISO can both be attached
at the same time so the installer can load the drivers without an ISO swap.

..
SCREENSHOT NEEDED: Instance detail page -> ISO tab showing two attached ISOs
each listed with its slot label tag (e.g. "hdc", "hdd").

.. _adding-an-iso:
Adding an ISO
-------------
Expand Down Expand Up @@ -571,10 +581,39 @@ Attaching an ISO to a Instance

#. Click the Attach ISO button. |iso.png|

#. In the Attach ISO dialog box, select the desired ISO.
#. In the Attach ISO dialog box, select one or more ISOs.

#. Click OK.

..
SCREENSHOT NEEDED: Multi-select Attach ISO dialog with the "ISO name (X / N)"
counter visible and one or two ISOs selected from the dropdown.

The maximum number of ISOs that may be attached to an Instance is controlled
by the configuration setting ``vm.cdrom.max.count`` (default ``1``); on KVM,
the hypervisor caps it at ``2``. The first ISO attached is the bootable one;
the Attach ISO action is hidden once the Instance reaches its limit.

Detaching an ISO
----------------

#. In the left navigation, click Instances.

#. Choose the Instance you want to work with.

#. Click the Detach ISO button.

#. In the Detach ISO dialog box, select one or more ISOs to detach.

#. Click OK.

..
SCREENSHOT NEEDED: Multi-select Detach ISO dialog showing two attached ISOs
Copy link
Copy Markdown
Member

@harikrishna-patnala harikrishna-patnala May 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please add all relevant screenshots

with their slot labels (e.g. "Rocky 8.4 boot (hdc)", "dummy (hdd)").

When more than one ISO is attached, each entry in the dialog shows its
CD-ROM slot label so the right one can be picked.



.. |sysmanager.png| image:: /_static/images/sysmanager.png
Expand Down
Loading