diff options
| author | Florian Pelz <pelzflorian@pelzflorian.de> | 2023-08-31 12:44:55 +0200 |
|---|---|---|
| committer | Florian Pelz <pelzflorian@pelzflorian.de> | 2023-09-02 13:35:32 +0200 |
| commit | 2890114a708e3a54a14ceb762f0726b013ffdc85 (patch) | |
| tree | 452665c86b6b185edfbb925ac809b13b33e1fa8c /doc | |
| parent | 8c0c94bf9f70a9252cd6f4261d2bce6bdba2bd0b (diff) | |
doc: Describe black screen issue when booting the installer.
With suggestions by Iku-Tulo Vilutar <ikutulovilutar@gmail.com>.
Fixes <https://issues.guix.gnu.org/65572>.
* doc/guix.texi (System Installation): Add suggestion when
booting the installer fails with a black screen.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guix.texi | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 04e5875925..464060f42c 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 even after you +waited for ten minutes. This may indicate that your machine cannot run +Guix System; perhaps you instead want to install Guix on a foreign +distro (@pxref{Binary Installation}). But don't give up just yet; a +possible workaround is pressing the @kbd{e} key in the GRUB boot menu +and appending @option{nomodeset} 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). |