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:
95guix system disk-image /path/to/this/channel/nongnu/system/install.scm 95guix system disk-image /path/to/this/channel/nongnu/system/install.scm
96#+end_src 96#+end_src
97 97
98Then you can write the generated disk image to a USB thumbdrive with:
99
100#+BEGIN_SRC sh
101# NOTE: This example assumes your thumbdrive is recognized by Linux as /dev/sdb.
102dd if=/path/to/disk-image of=/dev/sdb bs=4M status=progress oflag=sync
103#+END_SRC
104
105The installation media produced by the above method does not automatically
106configure your channels specification. You need to add Nonguix "manually"
107into ~/etc/guix/channels.scm~ and then run ~guix pull~ to make Guix aware of
108Nonguix scheme libraries. Below is Guile scheme code to include Nonguix in the
109channel specification.
110
111#+BEGIN_SRC scheme
112(use-modules (ice-9 pretty-print))
113(with-output-to-file "/etc/guix/channels.scm"
114 (lambda _
115 (pretty-print
116 '(cons*
117 (channel (name 'nonguix)
118 (url "https://gitlab.com/nonguix/nonguix"))
119 %default-channels))))
120#+END_SRC
121
98** CPU Microcode 122** CPU Microcode
99 123
100CPU microcode updates are nonfree blobs that apply directly to a processor to 124CPU microcode updates are nonfree blobs that apply directly to a processor to