From 069c805d04999c31bbb2251b3407432ff236d98e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Pierret=20=28fepitre=29?= Date: Wed, 23 Jun 2021 16:23:12 +0200 Subject: [PATCH 1/2] troubleshooting: add qubes.skip_autostart Related QubesOS/qubes-issues#4312 --- user/troubleshooting/skip-qubes-autostart.md | 25 ++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 user/troubleshooting/skip-qubes-autostart.md diff --git a/user/troubleshooting/skip-qubes-autostart.md b/user/troubleshooting/skip-qubes-autostart.md new file mode 100644 index 00000000..987f2ff8 --- /dev/null +++ b/user/troubleshooting/skip-qubes-autostart.md @@ -0,0 +1,25 @@ +--- +lang: en +layout: doc +permalink: /doc/skip-qubes-autostart/ +title: Skip Qubes OS autostart +--- + +In several cases, it is needed to prevent `autostart=True` for qubes on boot. For example: + +* `sys-usb` was enabled but the only keyboard is on USB and qubes.InputKeyboard service is disabled, +* Some PCI device assigned to autostart VM crashes the system (e.g. GPU or RAID controller cards). + +For that, there exists `qubes.skip_autostart` option on kernel command line. In order to use it, at the grub boot menu, + +[![grub1.png](/attachment/doc/grub1.png)](/attachment/doc/grub1.png) + +press `e` on the first entry (or any of your usual/custom entry). Then, press down key multiple times to reach the line starting by `module2`. + +[![grub2.png](/attachment/doc/grub2.png)](/attachment/doc/grub2.png) + +Append to the end of this line (generally after `rhgb quiet` options) `qubes.skip_autostart` + +[![grub3.png](/attachment/doc/grub3.png)](/attachment/doc/grub3.png) + +and press `Control-x` to boot the edited GRUB entry. The boot proceeds as usual with LUKS password prompt and then boot only the Qubes services without starting any qube. From bccc64d480f96f6b03df28d7baac7d3ffbf20918 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Pierret=20=28fepitre=29?= Date: Wed, 23 Jun 2021 18:46:20 +0200 Subject: [PATCH 2/2] skip-autostart: precise supported releases and modes --- user/troubleshooting/skip-qubes-autostart.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/user/troubleshooting/skip-qubes-autostart.md b/user/troubleshooting/skip-qubes-autostart.md index 987f2ff8..06fa58f9 100644 --- a/user/troubleshooting/skip-qubes-autostart.md +++ b/user/troubleshooting/skip-qubes-autostart.md @@ -5,6 +5,8 @@ permalink: /doc/skip-qubes-autostart/ title: Skip Qubes OS autostart --- +The following instructions are valid for Qubes OS R4.0 *legacy mode* only and Qubes OS R4.1 *legacy* and *UEFI* modes. For Qubes OS R4.0 in UEFI mode, we don't have GRUB so manual boot from another operating system is needed. + In several cases, it is needed to prevent `autostart=True` for qubes on boot. For example: * `sys-usb` was enabled but the only keyboard is on USB and qubes.InputKeyboard service is disabled,