Next: , Previous: , Up: Substitutes   [Contents][Index]

3.3.2 Substitute Server Authorization

To allow Guix to download substitutes from or a mirror thereof, you must add its public key to the access control list (ACL) of archive imports, using the guix archive command (see Invoking guix archive). Doing so implies that you trust to not be compromised and to serve genuine substitutes.

The public key for is installed along with Guix, in prefix/share/guix/, where prefix is the installation prefix of Guix. If you installed Guix from source, make sure you checked the GPG signature of guix-0.14.0.tar.gz, which contains this public key file. Then, you can run something like this:

# guix archive --authorize < prefix/share/guix/

Note: Similarly, the file contains the public key for the project’s new build farm, reachable at ‘’.

As of this writing is being upgraded so it can better scale up, but you might want to give it a try. It is backed by 20 x86_64/i686 build nodes and may be able to provide substitutes more quickly than

Once this is in place, the output of a command like guix build should change from something like:

$ guix build emacs --dry-run
The following derivations would be built:

to something like:

$ guix build emacs --dry-run
112.3 MB would be downloaded:

This indicates that substitutes from are usable and will be downloaded, when possible, for future builds.

The substitute mechanism can be disabled globally by running guix-daemon with --no-substitutes (see Invoking guix-daemon). It can also be disabled temporarily by passing the --no-substitutes option to guix package, guix build, and other command-line tools.

Next: , Previous: , Up: Substitutes   [Contents][Index]