From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id wHbTLAWr8WRNoQAAauVa8A:P1 (envelope-from ) for ; Fri, 01 Sep 2023 11:12:37 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id wHbTLAWr8WRNoQAAauVa8A (envelope-from ) for ; Fri, 01 Sep 2023 11:12:37 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 49B44656F9 for ; Fri, 1 Sep 2023 11:12:37 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=dYG6pJWL; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693559557; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=G2VUd2s0qos+A8ttFvFm/G+7kx4MioPxcZ2XTc0hjok=; b=cCaGfTYbV03uYTewRzNK5//cRPKMYL1ZLNEg+jd6jeU1a0RYgUVLARtQkE9hqmjcM64Fc0 +Z9ukc8/MfLzWPNlMF+eSVaUy28wVV3J+lJ1qDv6cdH58gvbzP/i/wpn0hF4Cas04p25r/ mq0Iu10rcisszDG4t26oMCT86mW1KKsi0SzN++cuVq9CNEoBr+gEZRJYP1bAx5gjQYVMjD 1Ny7ZFmI+/TpRCnm79M0prGficE2adf74tDu+wxFlcD6gRNO4L2u7NMcg1Z0Dk82/I6qzG e7xC1G8V+KfgAOjHysBcEo9CQUt181EbKBimkSYN7u7sqllxmk760WBzKjQYOw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b=dYG6pJWL; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693559557; a=rsa-sha256; cv=none; b=dPiXSDzkgRv8Xn8DoCwxDnqMwvDM1oYbr1I8Y5WiENOrneXW3b5HEs0g1JDUDrOFTwI1uK jos6xh7GD1lHV9+cYxwhEanqYjgFCim0ytquz+2DnQmsEhhKvnrO2JhvT1pkbzSUXRMJJR UYv/Zh6SPVuoYTPuGsQE5RPyQ+wfY1MtVTHAOVxAd+VDhNnZ4IoidlmVhy9xcxXcwZtw0T Hu8o1M5RMGLMkUT8JzjAI53uL059gk68iallsvQI62cDIlG8YegqZ2q1Oz/RoFKszgve3v 9rHJUVDbZYHXWWT0kTmI+HoPHE/pW4ZuPEoTCaEB7IV5O7MZfD50YZGUZGHxtA== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qc0A7-00015H-5g; Fri, 01 Sep 2023 05:09:55 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qc0A5-00012o-C0 for bug-guix@gnu.org; Fri, 01 Sep 2023 05:09:53 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qc0A5-0003ZJ-49 for bug-guix@gnu.org; Fri, 01 Sep 2023 05:09:53 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qc0AE-0007rT-5a for bug-guix@gnu.org; Fri, 01 Sep 2023 05:10:02 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#65572: [PATCH v3] doc: Describe black screen issue when booting the installer. References: In-Reply-To: Resent-From: Florian Pelz Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Fri, 01 Sep 2023 09:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 65572 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 65572@debbugs.gnu.org Cc: ikutulovilutar@gmail.com, Florian Pelz Received: via spool by 65572-submit@debbugs.gnu.org id=B65572.169355939530202 (code B ref 65572); Fri, 01 Sep 2023 09:10:02 +0000 Received: (at 65572) by debbugs.gnu.org; 1 Sep 2023 09:09:55 +0000 Received: from localhost ([127.0.0.1]:59850 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qc0A6-0007r3-LE for submit@debbugs.gnu.org; Fri, 01 Sep 2023 05:09:54 -0400 Received: from relay.yourmailgateway.de ([188.68.63.174]:42779) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qc0A4-0007qt-Ff for 65572@debbugs.gnu.org; Fri, 01 Sep 2023 05:09:53 -0400 Received: from mors-relay8204.netcup.net (localhost [127.0.0.1]) by mors-relay8204.netcup.net (Postfix) with ESMTPS id 4RcXKd60W4z8Z65; Fri, 1 Sep 2023 09:09:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1693559381; bh=Cheo5Zj9mdkQXo5zer6a+bKhKYHF6J+bQKo3gAU+/jU=; h=From:To:Cc:Subject:Date:From; b=dYG6pJWLdviPPm+z/Gnq1ztjyl3/Cp/HwAKsN4YuWsiqY/nc3e7BFAISE5yAPHnNt 3nv/kTX7B/wzNbc7syAh9V2Jd/ChtS8mOPntR3Hr2mRMrJuVjJ/gJ9ptevj1ygIRVP K9wumvS/J7eOxiDMHYUoqJkR+yuJ1WvrJXbAOxa1JH1cJK9FFMWwj470x1HDNqg3J5 aVbWkOhIl+iISceadjbuU7GPN6HtmxPe5cACEjl4mMpMZkI0WGFIgcotr2NSfwm7OX 2hLwYprXKOb1nVo/GMkIGCyL06XGYpwzMWt+vhoWpJFXhWJNM0SAcPBNCm6l5sVsiq bUKZtxGmlnaig== Received: from policy01-mors.netcup.net (unknown [46.38.225.35]) by mors-relay8204.netcup.net (Postfix) with ESMTPS id 4RcXKd5Hrxz8Z5w; Fri, 1 Sep 2023 09:09:41 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at policy01-mors.netcup.net Received: from mxe217.netcup.net (unknown [10.243.12.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by policy01-mors.netcup.net (Postfix) with ESMTPS id 4RcXKV1bsBz8sX7; Fri, 1 Sep 2023 11:09:34 +0200 (CEST) Received: from florianrock64.fritz.box (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id E60A2819F8; Fri, 1 Sep 2023 11:09:27 +0200 (CEST) From: Florian Pelz Date: Fri, 1 Sep 2023 11:07:19 +0200 Message-ID: <20230901090856.2468-1-pelzflorian@pelzflorian.de> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: E60A2819F8 X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: aFkThsuYnQ5frYnlWAcLLRkQiKI9BaZXFQDGobscatTybu/JcLiqCgV7 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: bug-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Scanner: mx1.migadu.com X-Migadu-Spam-Score: -3.73 X-Spam-Score: -3.73 X-Migadu-Queue-Id: 49B44656F9 X-TUID: Qe+HG1f6+gDB With suggestions by Iku-Tulo Vilutar . Fixes . * doc/guix.texi (System Installation): Add suggestion when booting the installer fails with a black screen. --- changes: - tell users to wait 10 minutes, not 2 - don't suggest video=uvesafb which is without effect - more positive wording (don't give up just yet) doc/guix.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) 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). base-commit: b51e45d3aaa8a85d39a8a4c3d18e8b57254aeaf2 -- 2.41.0