Please add this to the README.rst
duaneellissd opened this issue · comments
Please add this to the Install/Update/Remove section, it was not obvious to me, and took quite a bit of digging to uncover.
Trouble Shooting Installation Issues & Errors
- Windows10 using secure boot requires signed drivers
- Option 1 - Obtain your own signing key and follow the instructions below.
- Option 2 - Disable UEFI secure boot, and enable Windows Test Mode
- Examining the SetupAPI log file helps, see:
C:\Windows\INF\setupapi.dev.log
Helpful Trouble Shooting links:
- Secure Boot: Varies depending on PC Maker and/or the BIOS setting on your test machine.
- https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/disabling-secure-boot
- VMWare (one example): https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-898217D4-689D-4EB5-866C-888353FE241C.html
- Virtual Box: SecureBoot is not supported on Virtual Box
- Parallels (MacOS) https://kb.parallels.com/en/124242 [With Parallels 15, it is enabled by default, use 0 to disable]
- Windows Test mode
https://docs.microsoft.com/en-us/windows-hardware/drivers/install/the-testsigning-boot-configuration-option
@lstipakov what can we do about this?
The readme needs an update, indeed. For example, cross-signing has been discontinued, so that part needs rework. Unfortunately am a bit busy with other things right now.
@duaneellissd I see that we already mention attestation signing, test signing and secure boot. I added mention of SetupAPI.dev.log. If you think it is not enough, feel free to open a PR.