From fd4689ae283d16d81b773ecde42ed8df94d00f4d Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Wed, 7 Jan 2026 17:02:40 +0530 Subject: [PATCH] vm: note on skip forced disk controllers uefi secure boot Related https://github.com/apache/cloudstack/pull/11750 Signed-off-by: Abhishek Kumar --- 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 49ab2b6fbc..1b59d4cb1e 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: + + - 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: + + ``skip.force.disk.controller = true`` + + When set, disk controller enforcement is skipped and the controllers defined by template/instance details are used. Install Required Tools and Drivers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~