installation: add `nomodeset` kernel parameter tip for bogus graphics

[pmg-docs.git] / pmg-installation.adoc

diff --git a/pmg-installation.adoc b/pmg-installation.adoc
index 9f43f707c95d9153654aa47e7bb492530b359d9f..8833b417be0b4a1076012aaec315c3528b909658 100644 (file)
--- a/pmg-installation.adoc
+++ b/pmg-installation.adoc
@@ -272,6 +272,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 {pmg} bootloader menu, navigate to 'Install {pmg} (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.
+
 [[pmg_install_on_debian]]
 Install {pmg} on Debian
 -----------------------