From 6e6f88ac4557109fddab5d46a225199ca763f226 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Thalheim?= Date: Tue, 30 Sep 2025 11:05:20 +0200 Subject: [PATCH] add changelog for http binary cache compression --- .../rl-next/http-binary-cache-compression.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 doc/manual/rl-next/http-binary-cache-compression.md diff --git a/doc/manual/rl-next/http-binary-cache-compression.md b/doc/manual/rl-next/http-binary-cache-compression.md new file mode 100644 index 000000000..88f1de6d9 --- /dev/null +++ b/doc/manual/rl-next/http-binary-cache-compression.md @@ -0,0 +1,19 @@ +--- +synopsis: "HTTP binary caches now support transparent compression for metadata" +prs: [] +--- + +HTTP binary cache stores can now compress `.narinfo`, `.ls`, and build log files before uploading them, +reducing bandwidth usage and storage requirements. The compression is applied transparently using the +`Content-Encoding` header, allowing compatible clients to automatically decompress the files. + +Three new configuration options control this behavior: +- `narinfo-compression`: Compression method for `.narinfo` files +- `ls-compression`: Compression method for `.ls` files +- `log-compression`: Compression method for build logs in `log/` directory + +Example usage: +``` +nix copy --to 'http://cache.example.com?narinfo-compression=gzip&ls-compression=gzip' /nix/store/... +nix store copy-log --to 'http://cache.example.com?log-compression=br' /nix/store/... +```