summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2016-01-18 15:28:30 +0100
committerLudovic Courtès <ludo@gnu.org>2016-01-18 17:41:16 +0100
commite0c941fefa0769bd834cee220a640ce5b9b0c3f6 (patch)
treec418acce79f6988f3d7bd9acce3e7891914072f8 /doc
parent44ad33843a5653bf9e49b37d7fdd2903a9142ee0 (diff)
downloadguix-e0c941fefa0769bd834cee220a640ce5b9b0c3f6.tar.gz
doc: Document 'http_proxy'.
* doc/guix.texi (Build Environment Setup, Substitutes): Document
'http_proxy'.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index a7da452fff..592ec3cb1d 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -634,6 +634,11 @@ This way, the value of @code{TMPDIR} does not leak inside build
 environments, which avoids discrepancies in cases where build processes
 capture the name of their build tree.
 
+@vindex http_proxy
+The daemon also honors the @code{http_proxy} environment variable for
+HTTP downloads it performs, be it for fixed-output derivations
+(@pxref{Derivations}) or for substitutes (@pxref{Substitutes}).
+
 If you are installing Guix as an unprivileged user, it is still possible
 to run @command{guix-daemon} provided you pass @code{--disable-chroot}.
 However, build processes will not be isolated from one another, and not
@@ -1685,6 +1690,14 @@ Guix ignores substitutes that are not signed, or that are not signed by
 one of the keys listed in the ACL.  It also detects and raises an error
 when attempting to use a substitute that has been tampered with.
 
+@vindex http_proxy
+Substitutes are downloaded over HTTP.  The @code{http_proxy} environment
+variable can be set in the environment of @command{guix-daemon} and is
+honored for downloads of substitutes.  Note that the value of
+@code{http_proxy} in the environment where @command{guix build},
+@command{guix package}, and other client commands are run has
+@emph{absolutely no effect}.
+
 The substitute mechanism can be disabled globally by running
 @code{guix-daemon} with @code{--no-substitutes} (@pxref{Invoking
 guix-daemon}).  It can also be disabled temporarily by passing the