qubes-doc/user/troubleshooting/autostart-troubleshooting.md

37 lines
1.3 KiB
Markdown
Raw Normal View History

---
lang: en
layout: doc
permalink: /doc/autostart-troubleshooting/
title: Autostart Troubleshooting
---
2021-06-26 09:24:32 -04:00
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.
2021-06-26 09:24:32 -04:00
In several cases, there is a need to prevent `autostart=True` for qubes on
boot. For example:
2021-06-26 09:24:32 -04:00
* `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).
2021-06-26 09:24:32 -04:00
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)
2021-06-26 09:24:32 -04:00
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)
2021-06-26 09:24:32 -04:00
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)
2021-06-26 09:24:32 -04:00
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.