nixos/doc/manual/administration/network-problems.section.md

   1 # Network Problems {#sec-nix-network-issues}
   2
   3 Nix uses a so-called *binary cache* to optimise building a package from
   4 source into downloading it as a pre-built binary. That is, whenever a
   5 command like `nixos-rebuild` needs a path in the Nix store, Nix will try
   6 to download that path from the Internet rather than build it from
   7 source. The default binary cache is `https://cache.nixos.org/`. If this
   8 cache is unreachable, Nix operations may take a long time due to HTTP
   9 connection timeouts. You can disable the use of the binary cache by
  10 adding `--option use-binary-caches false`, e.g.
  11
  12 ```ShellSession
  13 # nixos-rebuild switch --option use-binary-caches false
  14 ```
  15
  16 If you have an alternative binary cache at your disposal, you can use it
  17 instead:
  18
  19 ```ShellSession
  20 # nixos-rebuild switch --option binary-caches http://my-cache.example.org/
  21 ```