2021-06-23 10:23:12 -04:00
|
|
|
---
|
|
|
|
|
lang: en
|
|
|
|
|
layout: doc
|
2021-06-26 09:10:49 -04:00
|
|
|
permalink: /doc/autostart-troubleshooting/
|
2021-07-08 21:06:41 -04:00
|
|
|
title: Autostart troubleshooting
|
2021-06-23 10:23:12 -04:00
|
|
|
---
|
|
|
|
|
|
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-23 12:46:20 -04:00
|
|
|
|
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-23 10:23:12 -04:00
|
|
|
|
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-23 10:23:12 -04:00
|
|
|
|
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.
|
2021-06-23 10:23:12 -04:00
|
|
|
|
|
|
|
|
[](/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`.
|
2021-06-23 10:23:12 -04:00
|
|
|
|
|
|
|
|
[](/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).
|
2021-06-23 10:23:12 -04:00
|
|
|
|
|
|
|
|
[](/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.
|
