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

Christoph Heiss c.heiss at proxmox.com
Fri Nov 24 11:45:59 CET 2023

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
+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
+Then press `Ctrl-X` or `F10` to boot the configuration.
 Install {pve} on Debian

More information about the pve-devel mailing list