diff --git a/doc/manual/conf-file.xml b/doc/manual/conf-file.xml
index 2dc260b35..6a575b9e3 100644
--- a/doc/manual/conf-file.xml
+++ b/doc/manual/conf-file.xml
@@ -318,6 +318,16 @@ build-use-chroot = /dev /proc /bin
+ use-binary-caches
+
+ If set to true (the default),
+ Nix will check the binary caches specified by
+ and related options to obtain
+ binary substitutes.
+
+
+
+
binary-caches
A list of URLs of binary caches, separated by
diff --git a/scripts/download-from-binary-cache.pl.in b/scripts/download-from-binary-cache.pl.in
index 74df79d8f..a018b3b2a 100644
--- a/scripts/download-from-binary-cache.pl.in
+++ b/scripts/download-from-binary-cache.pl.in
@@ -177,6 +177,10 @@ sub getAvailableCaches {
return if $gotCaches;
$gotCaches = 1;
+ return if
+ ($Nix::Config::config{"use-binary-caches"} // "true") eq "false" ||
+ ($Nix::Config::config{"untrusted-use-binary-caches"} // "true") eq "false";
+
sub strToList {
my ($s) = @_;
return map { s/\/+$//; $_ } split(/ /, $s);