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:
parent
6c3b84b0be
commit
8d982af6fd
27
README.org
27
README.org
|
@ -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))
|
||||||
|
|
Loading…
Reference in New Issue
Block a user