summary refs log tree commit diff
path: root/doc/functions/prefer-remote-fetch.section.md
blob: 8760c100224a73c31d30844c0d98b27457ecb223 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# prefer-remote-fetch overlay {#sec-prefer-remote-fetch}

`prefer-remote-fetch` is an overlay that download sources on remote builder. This is useful when the evaluating machine has a slow upload while the builder can fetch faster directly from the source. To use it, put the following snippet as a new overlay:

```nix
self: super:
  (super.prefer-remote-fetch self super)
```

A full configuration example for that sets the overlay up for your own account, could look like this

```ShellSession
$ mkdir ~/.config/nixpkgs/overlays/
$ cat > ~/.config/nixpkgs/overlays/prefer-remote-fetch.nix <<EOF
  self: super: super.prefer-remote-fetch self super
EOF
```