installation: add section about booting with `nomodeset`

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

diff --git a/pve-installation.adoc b/pve-installation.adoc
index 6e011fa7391ca1af3283c7fb23e06f134be6845a..56b18c82222ef968d7cd30ecd0d33e846c80efae 100644 (file)
--- 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