Recommend EFI and SCSI (virtio-scsi) for KVM (#795)

* Booting required EFI BIOS in my environment. * virtio-scsi is required to ensure the disk is /dev/sda and the EFI firmware can boot from it. Signed-off-by: Kurt Garloff <[email protected]>
osism · Feb 13, 2025 · 5cf30d2 · 5cf30d2
1 parent 3bf63bd
commit 5cf30d2
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/docs/cloud-in-a-box/running-on-a-virtual-machine.md b/docs/cloud-in-a-box/running-on-a-virtual-machine.md
@@ -13,6 +13,23 @@ To enable nested virtualization the CPU configuration of the VM has to be `host-
 
 The linked guide can be used in other distributions as well.
 
+### EFI
+
+Chose an EFI firmware instead of classical BIOS to ensure the booting from the disk with the GPT
+partition table works.
+
+### SCSI
+
+Use the `-1.iso` variant that installs to a SCSI disk `/dev/sda` and chose the virtio-scsi controller
+in the VM configuration. In a libvirt configuration file, this will look like this (this bus number of
+course depends on the other virtual PCI devices):
+
+```xml
+    <controller type='scsi' index='0' model='virtio-scsi'>
+      <address type='pci' domain='0x0000' bus='0x07' slot='0x00' function='0x0'/>
+    </controller>
+```
+
 ### Disk space saving
 
 When using Cloud in a Box in a VM, you can utilize the qcow2 disk image or similar technology to save space.