HTTP Binary Cache Store

Store URL format: http://..., https://...

This store allows a binary cache to be accessed via the HTTP protocol.

Settings

• compression

  NAR compression method. One of: xz, bzip2, gzip, zstd, none, br, compress, grzip, lrzip, lz4, lzip, lzma or lzop. To use a particular compression method Nix has to be built with a version of libarchive that natively supports that compression algorithm.

  Default: xz

• compression-level

  The preset level to be used when compressing NARs. The meaning and accepted values depend on the compression method selected. -1 specifies that the default compression level should be used.

  Default: -1

• index-debug-info

  Whether to index DWARF debug info files by build ID. This allows dwarffs to fetch debug info on demand

  Default: false

• local-nar-cache

  Path to a local cache of NARs fetched from this binary cache, used by commands such as nix store cat.

  Default: ``

• log-compression

  Compression method for log/* files. It is recommended to use a compression method supported by most web browsers (e.g. brotli).

  Default: ``

• ls-compression

  Compression method for .ls files.

  Default: ``

• narinfo-compression

  Compression method for .narinfo files.

  Default: ``

• parallel-compression

  Enable multi-threaded compression of NARs. This is currently only available for xz and zstd.

  Default: false

• path-info-cache-size

  Size of the in-memory store path metadata cache.

  Default: 65536

• priority

  Priority of this store when used as a substituter. A lower value means a higher priority.

  Default: 0

• secret-key

  Path to the secret key used to sign the binary cache.

  Default: empty

• secret-keys

  List of comma-separated paths to the secret keys used to sign the binary cache.

  Default: empty

• store

  Logical location of the Nix store, usually /nix/store. Note that you can only copy store paths between stores if they have the same store setting.

  Default: /nix/store

• system-features

  Optional system features available on the system this store uses to build derivations.

  Example: "kvm"

  Default: machine-specific

• tls-certificate

  Path to an optional TLS client certificate in PEM format.

  Default: ``

• tls-private-key

  Path to an optional TLS client certificate private key in PEM format.

  Default: ``

• trusted

  Whether paths from this store can be used as substitutes even if they are not signed by a key listed in the trusted-public-keys setting.

  Default: false

• use-bloom-filter

  Whether to use the Bloom filter advertised by this binary cache (if any) to avoid querying .narinfo files for store paths that are definitely not in the cache. Set to false to disable this optimization.

  Default: true

• want-mass-query

  Whether this store can be queried efficiently for path validity when used as a substituter.

  Default: false

• write-nar-listing

  Whether to write a JSON file that lists the files in each NAR.

  Default: false