aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/src/package-management/terminology.md
blob: 8dc2ede33d0a71dcca53c821f8f56b24191f8994 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# Terminology

A *local store* exists on the local filesystem of the machine where
Nix is invoked.  The `/nix/store` directory is one example of a
local store.  You can use other local stores by passing the
`--store` flag to `nix`.

A *remote store* is a store which exists anywhere other than the
local filesystem.  One example is the `/nix/store` directory on
another machine, accessed via `ssh` or served by the `nix-serve`
Perl script.

A *binary cache* is a remote store which is not the local store of
any machine.  Examples of binary caches include S3 buckets and the
[NixOS binary cache](https://cache.nixos.org).  Binary caches use a
disk layout that is different from local stores; in particular, they
keep metadata and signatures in `.narinfo` files rather than in
`/nix/var/nix/db`.

A *substituter* is a store other than `/nix/store` from which Nix will
copy the realisation of a derivation instead of building it.  Nix will
not copy a realisation from a remote store unless one of the following
is true:

- the realisation is signed by one of the `trusted-public-key`s
- the substituter is in the `trusted-substituters` list
- the `no-require-sigs` option has been set to disable signature checking
- the derivation is a fixed-output derivation