summaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorSergiu Ivanov <sivanov@colimite.fr>2021-12-05 22:35:00 +0100
committerJonathan Brielmaier <jonathan.brielmaier@web.de>2021-12-12 22:29:19 +0100
commit4725a85f893767793d1e874642e130146f85dfcb (patch)
tree89869b8966a5d5e5bf84ecff648287b99da6a3e2 /README.org
parent5b1184a103640186fd22e1c53ba64a83f7e6fc3d (diff)
README.org: Add instructions how to add our substitution server.
* README.org (Substitutes for nonguix): New chapter. (Avoiding kernel recompilation): rename heading to "Pinning package versions". Signed-off-by: Jonathan Brielmaier <jonathan.brielmaier@web.de>
Diffstat (limited to 'README.org')
-rw-r--r--README.org35
1 files changed, 33 insertions, 2 deletions
diff --git a/README.org b/README.org
index 1f80646..f006945 100644
--- a/README.org
+++ b/README.org
@@ -193,9 +193,40 @@ required, it is recommended to stay with Linux LTS releases:
...)
#+END_SRC
-** Avoiding kernel recompilation
+** Substitutes for nonguix
-Since prebuilt substitutes are not currently available for Nonguix, you may find
+A Nonguix substitute server is available at [[https://substitutes.nonguix.org]].
+On Guix System, you can add and authorize this URL in the following way:
+#+BEGIN_SRC scheme
+(operating-system
+ (services (modify-services %desktop-services
+ (guix-service-type config => (guix-configuration
+ (inherit config)
+ (substitute-urls
+ (append (list "https://substitutes.nonguix.org")
+ %default-substitute-urls))
+ (authorized-keys
+ (append (list (local-file "./signing-key.pub"))
+ %default-authorized-guix-keys))))))
+ ...)
+#+END_SRC
+
+Notice that the URL of the server should be specified without a trailing
+slash. The file ~signing-key.pub~ should be downloaded directly from
+[[https://substitutes.nonguix.org/signing-key.pub]].
+
+Alternatively, you can use replace ~(local-file "./signing-key.pub")~ by:
+#+BEGIN_SRC scheme
+(plain-file "non-guix.pub"
+ "<contents of signing-key.pub>")
+#+END_SRC
+
+Check out the [[https://guix.gnu.org/manual/en/html_node/Substitutes.html][chapter on substitutes]]
+in the Guix manual for more details.
+
+** Pinning package versions
+
+When using substitutes is not an option, you may find
that ~guix system reconfigure~ recompiles the kernel frequently due to version
bumps in the kernel package. An inferior can be used to pin the kernel version
and avoid lengthy rebuilds.