This is an automated email from the ASF dual-hosted git repository.
abhisar pushed a commit to branch 4.20
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.20 by this push:
new b627bc96 vm: note on skip forced disk controllers uefi secure boot
(#616)
b627bc96 is described below
commit b627bc961ac8e4b79adfb201447a7f7d2d261803
Author: Abhishek Kumar <[email protected]>
AuthorDate: Wed Apr 15 16:14:14 2026 +0530
vm: note on skip forced disk controllers uefi secure boot (#616)
* vm: note on skip forced disk controllers uefi secure boot
Related https://github.com/apache/cloudstack/pull/11750
Signed-off-by: Abhishek Kumar <[email protected]>
* Apply suggestion from @shwstppr
* Apply suggestions from code review
Co-authored-by: Suresh Kumar Anaparti <[email protected]>
---------
Signed-off-by: Abhishek Kumar <[email protected]>
Co-authored-by: Suresh Kumar Anaparti <[email protected]>
---
source/adminguide/virtual_machines.rst | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/source/adminguide/virtual_machines.rst
b/source/adminguide/virtual_machines.rst
index 49ab2b6f..3e67dd82 100644
--- a/source/adminguide/virtual_machines.rst
+++ b/source/adminguide/virtual_machines.rst
@@ -175,6 +175,18 @@ To create an Instance from a Template:
specified at the Instance or Template level. For an existing Instance its
settings can be updated while it is in
stopped state by admin.
+ **KVM**
+
+ Instances running on the KVM hypervisor with UEFI Secure Boot have disk
controllers automatically enforced as following:
+
+ - Windows OS instances use SATA
+ - Non-Windows OS instances use VirtIO
+
+ Starting with 4.20.3 and later, this behavior can be overridden by setting
the following template or instance detail to true:
+
+ ``skip.force.disk.controller = true``
+
+ When set to true, disk controller enforcement is skipped, and the
controllers defined by template/instance details are used. If the detail is
added at both template and instance level, the instance detail takes precedence.
Install Required Tools and Drivers
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
