[pve-devel] [PATCH docs v2 4/5] installation: add section about booting with `nomodeset`

[Christoph Heiss]

As the grub entry specific to this was removed with the 8.1 release, add
a separate section for this to link users too.

Unfortunaly it is relatively often needed, due to very old or very new
hardware, or when Nvidia cards are installed.

Signed-off-by: Christoph Heiss <c.heiss at proxmox.com>
---
Changes v1 -> v2:
  * no changes

 pve-installation.adoc | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/pve-installation.adoc b/pve-installation.adoc
index 6e011fa..56b18c8 100644
--- a/pve-installation.adoc
+++ b/pve-installation.adoc
@@ -300,6 +300,23 @@ following command:
 # zpool add <pool-name> log </dev/path_to_fast_ssd>
 ----

+Adding the `nomodeset` Kernel Parameter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Problems may arise on very old or very new hardware due to graphics drivers. If
+the installation hangs during the boot. In that case, you can try adding the
+`nomodeset` parameter. This prevents the Linux kernel from loading any
+graphics drivers and forces it to continue using the BIOS/UEFI-provided
+framebuffer.
+
+On the {pve} bootloader menu, navigate to 'Install {pve} (Terminal UI)' and
+press `e` to edit the entry. Using the arrow keys, navigate to the line starting
+with `linux`, move the cursor to the end of that line and add the
+parameter `nomodeset`, separated by a space from the pre-existing last
+parameter.
+
+Then press `Ctrl-X` or `F10` to boot the configuration.
+
 ifndef::wiki[]

 Install {pve} on Debian
--
2.42.0