diff --git a/user/troubleshooting/autostart-troubleshooting.md b/user/troubleshooting/autostart-troubleshooting.md index e206ef75..3d67d6be 100644 --- a/user/troubleshooting/autostart-troubleshooting.md +++ b/user/troubleshooting/autostart-troubleshooting.md @@ -5,23 +5,32 @@ permalink: /doc/autostart-troubleshooting/ title: Autostart Troubleshooting --- -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. +The following instructions are valid for **Qubes OS R4.0 legacy mode** and +**Qubes OS R4.1 legacy and UEFI modes**. For **Qubes OS R4.0 in UEFI mode**, +there is no 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: +In several cases, there is a need 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). +* `sys-usb` was enabled, but the only keyboard is attached via USB, and the + `qubes.InputKeyboard` service is disabled. +* A PCI device assigned to an autostarting qube crashes the system (e.g., a GPU + or RAID controller card). -For that, there exists `qubes.skip_autostart` option on kernel command line. In order to use it, at the grub boot menu, +To address this, there is a `qubes.skip_autostart` option for the kernel +command line. You can 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`. +Press the `E` key on the first prompt (or your custom prompt). Then, press the +down arrow key multiple times to reach the line starting with `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` +Append `qubes.skip_autostart` to the end of this line (generally after the +`rhgb quiet` options). [![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. +Press `Ctrl+X` to boot with the edited GRUB entry. The boot will proceed as +usual from here, except that no qube will be autostarted.