The cache-targets.toml file contains the build targets for the caching workflow (cache.yml).
This allows us to selectively build and push large or important derivations to Cachix so they can be reused.
Each target is defined as a table [[targets]]. Below are the supported properties:
group(string, required): The category of the target.- Examples:
"nixos_config_attribute","nixos_package","flake_package","vscode_extensions","remote_flake".
- Examples:
name(string, required): The attribute path, package name, or target identifier.- Example:
"boot.kernelPackages.kernel","zed-editor","xdg-desktop-portal-gtk4".
- Example:
hostname(string, optional): The target NixOS hostname (required fornixos_config_attributeornixos_packagegroups).- Example:
"Ainz-NIX".
- Example:
user(string, optional): The username associated with the target, often used for Home Manager packages or user-specific configurations (likevscode_extensions).large_build(boolean, optional): Set this totrueif the package takes up a significant amount of disk space to build (e.g., the Linux kernel). Whentrue, the CI will run a specializedsetup-nixcomposite action that aggressively reclaims runner disk space before building. Iffalseor omitted, it defaults to the much faster Determinate Systems Nix installer.