From: Florian Pelz Date: Thu, 31 Aug 2023 12:44:55 +0200 Subject: [PATCH] doc: Describe black screen issue when booting the installer. With suggestions by Iku-Tulo Vilutar . Fixes . * doc/guix.texi (System Installation): Add suggestion when booting the installer fails with a black screen. --- doc/guix.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 04e5875925..5aeed7851d 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -2402,6 +2402,16 @@ BIOS or UEFI boot menu, where you can choose to boot from the USB stick. In order to boot from Libreboot, switch to the command mode by pressing the @kbd{c} key and type @command{search_grub usb}. +Sadly, on some machines, the installation medium cannot be properly +booted and you only see a black screen after booting. This may +indicate that your machine cannot run Guix System; perhaps you instead +want to install Guix on a foreign distro (@pxref{Binary +Installation}). If you are adventurous, a possible workaround is +pressing the @kbd{e} key in the GRUB boot menu and appending +@option{nomodeset video=uvesafb} to the Linux bootline. Sometimes the +black screen issue can also be resolved by connecting a different +display. + @xref{Installing Guix in a VM}, if, instead, you would like to install Guix System in a virtual machine (VM). base-commit: 299d0463d54c97b237deb2fe9e464108544344c0 -- 2.41.0