[pve-devel] [PATCH docs 4/7] 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>
---
 pve-installation.adoc | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/pve-installation.adoc b/pve-installation.adoc
index 7d4d754..11ec892 100644
--- a/pve-installation.adoc
+++ b/pve-installation.adoc
@@ -299,6 +299,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