README.org: Clarify installation media channels procedure.

* README.org (Installation image): Current installation media does not need
manual channel configuration. Move instructions on adding the nonguix
channel during installation to ...
(Important note for 1.4.0): ... this new subsection.

Co-authored-by: Hilton Chain <hako@ultrarare.space>
This commit is contained in:
John Kehayias 2024-08-26 12:02:51 -04:00
parent 6c3b84b0be
commit 8d982af6fd
No known key found for this signature in database
GPG Key ID: 499097AE5EA815D9

View File

@ -96,20 +96,18 @@ your configuration.
For some hardware the official Guix installation image won't do For some hardware the official Guix installation image won't do
(e.g. unsupported wifi). You can find a pre-generated installation image (e.g. unsupported wifi). You can find a pre-generated installation image
(time and version in line with upstream Guix), running the nonfree Linux (time and version in line with upstream Guix), running the nonfree Linux
kernel and nonfree firmware, on the [[https://gitlab.com/nonguix/nonguix/-/releases][Releases page]]. Or, you can generate an kernel and nonfree firmware, on the [[https://gitlab.com/nonguix/nonguix/-/releases][Releases page]] (see below for important
installation image from a local checkout of this repository, at a more recent note if you use the 1.4.0 release or those created prior to April 2024). Or,
commit, with the following command: you can generate an installation image from a local checkout of this
repository, at a more recent commit, with the following command:
#+begin_src sh #+begin_src sh
guix system image --image-type=iso9660 /path/to/this/channel/nongnu/system/install.scm guix system image --image-type=iso9660 /path/to/this/channel/nongnu/system/install.scm
#+end_src #+end_src
Like the official Guix installation image, this will produce a read-only image Like the official Guix installation image, this will produce a read-only image
with any changes made stored in memory. As indicated below, you will need to with any changes made stored in memory. Alternatively, a writable image can
run ~guix pull~ to download the Nonguix package descriptions, so will need be created with the following command:
enough memory to hold the cached channel code which can be several hundred
megabytes. As an alternative, you can create a writable image with the
following command:
#+begin_src sh #+begin_src sh
guix system image --image-size=7.2GiB /path/to/this/channel/nongnu/system/install.scm guix system image --image-size=7.2GiB /path/to/this/channel/nongnu/system/install.scm
@ -126,11 +124,14 @@ Either type of image can be written to a USB thumbdrive with:
dd if=/path/to/disk-image of=/dev/sdb bs=4M status=progress oflag=sync dd if=/path/to/disk-image of=/dev/sdb bs=4M status=progress oflag=sync
#+END_SRC #+END_SRC
The installation media produced by the above method does not automatically *** Important note for 1.4.0
configure your channels specification. You need to add Nonguix "manually" The installation media for 1.4.0 or those produced manually before commit
into ~/etc/guix/channels.scm~ and then run ~guix pull~ to make Guix aware of [[https://gitlab.com/nonguix/nonguix/-/commit/80b273e86a19ceaee6d9b6650ed56e853409a799#note_2075084624][80b273e8]] (April 2024) do not automatically configure your channels
Nonguix scheme libraries. Below is Guile scheme code to include Nonguix in the specification. You need to add Nonguix "manually" into ~/etc/guix/channels.scm~
channel specification. and then run ~guix pull~ to make Guix aware of Nonguix scheme libraries. This
will require enough memory to hold the cached channel code which can be
several hundred megabytes. Below is Guile scheme code to include Nonguix in
the channel specification.
#+BEGIN_SRC scheme #+BEGIN_SRC scheme
(use-modules (ice-9 pretty-print)) (use-modules (ice-9 pretty-print))