bartronx7/guix
1
0
Fork 0
mirror of https://codeberg.org/guix/guix.git synced 2026-01-25 03:55:08 -06:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: Add note about <https://bugs.gnu.org/35541>.

Browse source 
* doc/guix.texi (Guided Graphical Installation): Add node about
<https://bugs.gnu.org/35541>.
(System Installation): Refer to it.
This commit is contained in:
Ludovic Courtès 2019-05-04 22:16:53 +02:00
parent 3a3e9f2bb5
commit 542e7fb57f
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5
1 changed files with 56 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

56
doc/guix.texi
View file

@ -1774,6 +1774,11 @@ on a machine. Guix, as a package manager, can
also be installed on top of a running GNU/Linux system,
@pxref{Installation}.
@quotation Important Note
@xref{Guided Graphical Installation}, on how to work around a bug that affects
the graphical installer in version 1.0.0.
@end quotation
@ifinfo
@quotation Note
@c This paragraph is for people reading this from tty2 of the
@ -1992,6 +1997,57 @@ dependencies of your system configuration can be downloaded. See the
The graphical installer is a text-based user interface. It will guide you,
with dialog boxes, through the steps needed to install GNU@tie{}Guix System.
@quotation Important Note
Due to a @uref{https://issues.guix.info/issue/35541, bug}, the graphical
installer of Guix 1.0.0 may produce a system configuration where essential
commands such as @command{ls} or @command{grep} are missing; as a side effect,
it also prevents logging in into Xfce. A new release will be published in the
coming weeks. Here is how you can work around it in the meantime on your
freshly installed system:
@itemize
@item
Install packages that provide those commands, along with the text editor of
your choice (for example, @code{emacs} or @code{vim}):
@example
guix install coreutils findutils grep procps sed emacs vim
@end example
At this point, the essential commands you would expect are available.
@item
Open your configuration file with your editor of choice, for example
@command{emacs}, running as root:
@example
sudo emacs /etc/config.scm
@end example
@item
Change the @code{packages} field to add the ``base packages'' to the list of
globally-installed packages, such that your configuration looks like this:
@lisp
(operating-system
;; ... snip ...
(packages (append (list (specification->package "nss-certs"))
%base-packages))
;; ... snip ...
)
@end lisp
@item
Reconfigure the system so that your new configuration is in effect:
@example
guix pull && sudo guix system reconfigure /etc/config.scm
@end example
@end itemize
We apologize for this embarrassing mistake.
@end quotation
The first dialog boxes allow you to set up the system as you use it during the
installation: you can choose the language, keyboard layout, and set up
networking, which will be used during the installation. The image below shows