Binary Cache: Difference between revisions

(One intermediate revision by one other user not shown)

Line 2:

A binary cache builds Nix packages and caches the result for other machines. Any machine with Nix installed can be a binary cache for another one, no matter the operating system.

~~If you are facing problems with derivations not being in a cache, try switching to a release version. Most caches will have many derivations for a specific release.~~

== Setting up a binary cache ==

Line 115:

Line 113:

To configure Nix to use a certain binary cache, refer to the Nix manual.<ref group="cf.">[https://nixos.org/nix/manual/#ch-files Nix Manual, 21. Files]</ref> Add the binary cache as substituter (see the option {{ic|substituters}}) and the public key to the trusted keys (see {{ic|trusted-public-keys}}).

{{tip|If you are facing problems with derivations not being in a cache, try switching to a release version. Most caches will have many derivations for a specific release.}}

Permanent use of binary cache:

Line 207:

}

</syntaxHighlight>

=== Binary cache priority ===

Each binary cache has a priority field. A lower number indicates a higher priority.<syntaxhighlight lang="shell-session">

$curl https://cache.nixos.org/nix-cache-info

StoreDir: /nix/store

WantMassQuery: 1

Priority: 40

</syntaxhighlight>You may want to override this value by appending <code>?priority=n</code> at the end of the cache url.<syntaxhighlight lang="nix">

substituters = https://nix-community.cachix.org?priority=1 https://cache.nixos.org?priority=2

</syntaxhighlight>

== Populating a binary cache ==

@@ Line 2: / Line 2: @@
 A binary cache builds Nix packages and caches the result for other machines. Any machine with Nix installed can be a binary cache for another one, no matter the operating system.
-If you are facing problems with derivations not being in a cache, try switching to a release version. Most caches will have many derivations for a specific release.
 == Setting up a binary cache ==
@@ Line 115: / Line 113: @@
 To configure Nix to use a certain binary cache, refer to the Nix manual.<ref group="cf.">[https://nixos.org/nix/manual/#ch-files Nix Manual, 21. Files]</ref> Add the binary cache as substituter (see the option {{ic|substituters}}) and the public key to the trusted keys (see {{ic|trusted-public-keys}}).
+{{tip|If you are facing problems with derivations not being in a cache, try switching to a release version. Most caches will have many derivations for a specific release.}}
 Permanent use of binary cache:
@@ Line 207: / Line 207: @@
 }
 </syntaxHighlight>
+=== Binary cache priority ===
+Each binary cache has a priority field. A lower number indicates a higher priority.<syntaxhighlight lang="shell-session">
+$curl https://cache.nixos.org/nix-cache-info
+StoreDir: /nix/store
+WantMassQuery: 1
+Priority: 40
+</syntaxhighlight>You may want to override this value by appending <code>?priority=n</code> at the end of the cache url.<syntaxhighlight lang="nix">
+substituters = https://nix-community.cachix.org?priority=1 https://cache.nixos.org?priority=2
+</syntaxhighlight>
 == Populating a binary cache ==