From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id WPUzKUb98GQpewEA9RJhRA:P1 (envelope-from ) for ; Thu, 31 Aug 2023 22:51:18 +0200 Received: from aspmx1.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id WPUzKUb98GQpewEA9RJhRA (envelope-from ) for ; Thu, 31 Aug 2023 22:51:18 +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 4D7E335709 for ; Thu, 31 Aug 2023 22:51:18 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b="f62a/fsU"; 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=1693515078; 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=blsx5v1na6a/OSICNmR8gq7Q+77/U9ANI9E2q96Uj+4=; b=YloaKS8/6d+e7O9Jsc1xdTGsHArDV1PGG2XNRYUsbhTYam9s45Qz2ymi25ehJXKRwdXo+L x6YRmHvV9jV3cHj9kDjopvWi4mJAxrEkv46yXfWAoE6U1mmJ3fxCjAf9NI1Thhtm2aV9sR +qDSE55a1Ni6mlVAxAHB/30aprXigRRRjUX6u8hDZjDwrdTE7/NFDpJNCob8lJGvKKwFXy z8V30TV0WiHTL7YHf1xne0kcPADmrbXq3i+G5PSUg4ul10HMQpGyEg5X1I/5hcNwYt1g+e HHu65QulEMYCjrhs1/Hwl5oBRHbLazZi1r2TYlHMT5js1bouIEsNh+GEGWC8Gw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693515078; a=rsa-sha256; cv=none; b=YbDlY0GiqGxIvyzevsdjFz8wcVAcwg5IL+/Sw9or2cttuzC/pB2ddCBzLkqm4HELcKwSno wnSZ47SynPWtjqtObjQ1dRa0qwMB/iHPfWj/COl9GsrxRgi5MtSySV8xH1nEEnkLPX5OSe MiuqmaC8g1yU58TR5fQNRlCqCIbOafgnWnHT85JN719Gjnnq88D8DOrzU/RudcKttY+odc EYi+cbTvCOZa2zXqp/PiP+gw8mItaP0Ij9DdmEjN0iBIQ059FmSXFOhY8Xuz+4Nq//CHf2 B95ZzPpVqaZGAT9IN09hmRS1YY7qbCtSYjy+6kx18d+rariNTnawClhgeLoYKg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=key2 header.b="f62a/fsU"; 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" Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qbocz-0001eJ-FH; Thu, 31 Aug 2023 16:50:57 -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 1qbocx-0001e7-6m for bug-guix@gnu.org; Thu, 31 Aug 2023 16:50:55 -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 1qbocv-0006o0-Rm for bug-guix@gnu.org; Thu, 31 Aug 2023 16:50:54 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qbod4-0003SY-Ig for bug-guix@gnu.org; Thu, 31 Aug 2023 16:51:02 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#65572: [PATCH v2] 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: Thu, 31 Aug 2023 20:51: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: Florian Pelz Received: via spool by 65572-submit@debbugs.gnu.org id=B65572.169351502313252 (code B ref 65572); Thu, 31 Aug 2023 20:51:02 +0000 Received: (at 65572) by debbugs.gnu.org; 31 Aug 2023 20:50:23 +0000 Received: from localhost ([127.0.0.1]:59345 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qbocR-0003Rg-8z for submit@debbugs.gnu.org; Thu, 31 Aug 2023 16:50:23 -0400 Received: from relay.yourmailgateway.de ([194.59.206.189]:52663) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qbocO-0003RU-Ke for 65572@debbugs.gnu.org; Thu, 31 Aug 2023 16:50:22 -0400 Received: from relay02-mors.netcup.net (localhost [127.0.0.1]) by relay02-mors.netcup.net (Postfix) with ESMTPS id 4RcCwK6p11z42CN for <65572@debbugs.gnu.org>; Thu, 31 Aug 2023 22:50:09 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1693515010; bh=Nt8kZGON6sTXnjnLhacyNq4Qf45+HHOM8rCcG6KafSY=; h=From:To:Cc:Subject:Date:From; b=f62a/fsURpbfWenQcwHelEM2rpIiBD9BW+XJ4ef374pL4YczUmTkyEXv3LX4Chxub xPUqdj+hzfExz4h5Gyb5vBWP6aZYpiMjfDIjebBrcP8uAr/0lLemrtRkxOMxQmU0bh N6eruWrTONtX+wPpiu6HOTu9V8CSeAQCX5s8plWiIcnU3DWs5Awr1UTQj1P9fkQ/c5 i6RhCcsTwyX9LufhEjB24XB/7fyOp39tIhai80f/OR1ChcTs07NLx6kEZUZGK8lstR f+gJHjUmFvuGbeAX46caTqjGMn/YCNRWz+NfR4tnUEfbNRWTn0pZXNfUmOFIFUh7kS 1x/CnsQsoy99A== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by relay02-mors.netcup.net (Postfix) with ESMTPS id 4RcCwK6Qzwz7w98 for <65572@debbugs.gnu.org>; Thu, 31 Aug 2023 22:50:09 +0200 (CEST) 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 policy02-mors.netcup.net (Postfix) with ESMTPS id 4RcCwK4mwsz8sWf for <65572@debbugs.gnu.org>; Thu, 31 Aug 2023 22:50:09 +0200 (CEST) Received: from florianrock64.fritz.box (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id CCB0C81AAE; Thu, 31 Aug 2023 22:50:07 +0200 (CEST) From: Florian Pelz Date: Thu, 31 Aug 2023 22:33:52 +0200 Message-ID: <20230831204854.4074-1-pelzflorian@pelzflorian.de> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-NC-CID: sP1gEmmJn1Mk8/2LnahlBgmy6ivLY4QzXz1/yd0Ka/NyPhs0i/6X2Uql 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-Spam-Score: -0.72 X-Spam-Score: -0.72 X-Migadu-Queue-Id: 4D7E335709 X-Migadu-Scanner: mx2.migadu.com X-TUID: Xe985WlbM5/9 With suggestions by Iku-Tulo Vilutar . Fixes . * doc/guix.texi (System Installation): Add suggestion when booting the installer fails with a black screen. --- Improved wording: * added "after waiting for two minutes" doc/guix.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 04e5875925..fba9df1cce 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 two 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}). 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: b51e45d3aaa8a85d39a8a4c3d18e8b57254aeaf2 -- 2.41.0