jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 09:17:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

installation: Instruct users to disable secureboot with virt-manager (#24904)

Browse Source 
* installation: Instruct users to disable secureboot with virt-manager

Modern distros ship a variety of UEFI binaries and selecting a secureboot one leads to an un-bootable VM as there are no secure-boot keys enrolled by default for the home-assistant OS.

Note explicitly that virt-manager users should pick the non-secureboot variant.

* Add secboot

Co-authored-by: Fabian Affolter <mail@fabian-affolter.ch>
This commit is contained in:
Peter Krempa 2022-11-12 11:43:22 +01:00 committed by GitHub
parent 246c86bc54
commit d29c8802df
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
source/_includes/installation/operating_system.md
View File

@ -239,15 +239,15 @@ _All these can be extended if your usage calls for more resources._
- title: VirtualBox - title: VirtualBox
content: | content: |
1. Create a new virtual machine 1. Create a new virtual machine
2. Select Type “Linux” and Version “Linux 2.6 / 3.x / 4.x (64-bit)” 2. Select Type "Linux" and Version "Linux 2.6 / 3.x / 4.x (64-bit)"
3. Select “Use an existing virtual hard disk file”, select the unzipped VDI file from above 3. Select "Use an existing virtual hard disk file", select the unzipped VDI file from above
4. Edit the “Settings” of the VM and go “System” then “Motherboard” and select “Enable EFI” 4. Edit the "Settings" of the VM and go "System" then "Motherboard" and select "Enable EFI"
5. Then go to “Network” “Adapter 1” choose “Bridged Adapter” and choose your Network adapter 5. Then go to "Network" "Adapter 1" choose "Bridged Adapter" and choose your Network adapter
<div class="note warning"> <div class="note warning">
Please keep in mind that the bridged adapter only functions over a hardwired ethernet connection. Please keep in mind that the bridged adapter only functions over a hardwired ethernet connection.
Using Wi-Fi on your VirtualBox host is unsupported. Using Wi-Fi on your VirtualBox host is unsupported.
</div> </div>
6. Then go to “Audio” and choose “Intel HD Audio” as Audio Controller. 6. Then go to "Audio" and choose "Intel HD Audio" as Audio Controller.
<div class="note info"> <div class="note info">
By default VirtualBox does not free up unused disk space. To automatically shrink the vdi disk image By default VirtualBox does not free up unused disk space. To automatically shrink the vdi disk image
@ -261,11 +261,11 @@ _All these can be extended if your usage calls for more resources._
- title: KVM (virt-manager) - title: KVM (virt-manager)
content: | content: |
1. Create a new virtual machine in `virt-manager` 1. Create a new virtual machine in `virt-manager`
2. Select “Import existing disk image”, provide the path to the QCOW2 image above 2. Select "Import existing disk image", provide the path to the QCOW2 image above
3. Choose “Generic Default” for the operating system 3. Choose "Generic Default" for the operating system
4. Check the box for “Customize configuration before install” 4. Check the box for "Customize configuration before install"
5. Select your bridge under “Network Selection” 5. Select your bridge under "Network Selection"
6. Under customization select “Overview” -> “Firmware” -> “UEFI x86_64: ...” 6. Under customization select "Overview" -> "Firmware" -> "UEFI x86_64: ...". Make sure to select a non-secureboot version of OVMF (does not contain the word `secure`, `secboot`, etc.), e.g., `/usr/share/edk2/ovmf/OVMF_CODE.fd`.
7. Click "Add Hardware" (bottom left), and select "Channel" 7. Click "Add Hardware" (bottom left), and select "Channel"
8. Select device type: "unix" 8. Select device type: "unix"
9. Select name: "org.qemu.guest_agent.0" 9. Select name: "org.qemu.guest_agent.0"