summaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorPierre Neidhardt <mail@ambrevar.xyz>2020-05-31 18:35:48 +0200
committerPierre Neidhardt <mail@ambrevar.xyz>2020-05-31 18:37:26 +0200
commit5e5c15c86ad06a4fd1e633e48e19672992f24014 (patch)
tree09d7dae7a88050eda965f624d653502fe6361b17 /README.org
parent30e93befe5b1e5c1295271cbb27d5d1a5e728f05 (diff)
doc: Detail how to use Nonguix from the booted installation media.
* README.org (Installation image): Add dd example and Guile snippet to generate channels including Nonguix.
Diffstat (limited to 'README.org')
-rw-r--r--README.org24
1 files changed, 24 insertions, 0 deletions
diff --git a/README.org b/README.org
index ea126cd..e0862cb 100644
--- a/README.org
+++ b/README.org
@@ -95,6 +95,30 @@ nonfree Linux kernel and nonfree firmware with the following command:
guix system disk-image /path/to/this/channel/nongnu/system/install.scm
#+end_src
+Then you can write the generated disk image to a USB thumbdrive with:
+
+#+BEGIN_SRC sh
+# NOTE: This example assumes your thumbdrive is recognized by Linux as /dev/sdb.
+dd if=/path/to/disk-image of=/dev/sdb bs=4M status=progress oflag=sync
+#+END_SRC
+
+The installation media produced by the above method does not automatically
+configure your channels specification. You need to add Nonguix "manually"
+into ~/etc/guix/channels.scm~ and then run ~guix pull~ to make Guix aware of
+Nonguix scheme libraries. Below is Guile scheme code to include Nonguix in the
+channel specification.
+
+#+BEGIN_SRC scheme
+(use-modules (ice-9 pretty-print))
+(with-output-to-file "/etc/guix/channels.scm"
+ (lambda _
+ (pretty-print
+ '(cons*
+ (channel (name 'nonguix)
+ (url "https://gitlab.com/nonguix/nonguix"))
+ %default-channels))))
+#+END_SRC
+
** CPU Microcode
CPU microcode updates are nonfree blobs that apply directly to a processor to