Skip to main content

aeroflare_push

aeroflare push​

Push a build to the cache

Synopsis​

Push builds to the OCI cache.

Each positional argument is a Nix installable, resolved to store paths before uploading:

  • a store path (/nix/store/xxx-yyy)
  • a result symlink (./result)
  • a flake reference (github:owner/repo, nixpkgs#hello, .#default)

Installables that are not yet built are built first. Store paths given via --store-path, --input, or piped stdin are taken literally.

Examples: aeroflare push ./result aeroflare push nixpkgs#hello aeroflare push github:owner/repo#default

aeroflare push [installable...] [flags]

Options​

--compression string Compression type: zstd, xz, gzip, none (default "zstd")
--force Force push files even if they exist in the index or upstream cache
-h, --help help for push
--input string File containing store paths (one per line, # for comments)
--keep Keep generated .nar and .narinfo files after the push
--prepare-refs Also prepare references that are not on the upstream cache (default true)
--signing-key string Path to Nix signing private key file
--store-path string Nix store path to prepare and push (e.g. /nix/store/xxx-yyy)
--upstream-cache string Upstream binary cache URL (empty to skip reference checking) (default "https://cache.nixos.org")
--workers int Number of concurrent workers (default 50)

Options inherited from parent commands​

--cache-url string OCI registry URL for the cache
--cf-account-id string Cloudflare Account ID
--cf-token string Cloudflare API Token
--github-token string GitHub Token
--gitlab-token string GitLab Token
-v, --verbose count Enable verbose output (-v for packages, -vv for requests)

SEE ALSO​

  • aeroflare - A high-performance OCI-backed Nix binary cache proxy and toolkit
Auto generated by spf13/cobra on 19-Jul-2026​