nix3-registry-resolve(1)
| nix3-registry-resolve(1) | General Commands Manual | nix3-registry-resolve(1) |
Warning
This program is
experimental
and its interface is subject to change.
Name
nix registry resolve - resolve flake references using the registry
Synopsis
nix registry resolve [option…] flake-refs…
Examples
- •
- Resolve the nixpkgs and blender-bin flakerefs:
# nix registry resolve nixpkgs blender-bin github:NixOS/nixpkgs/nixpkgs-unstable github:edolstra/nix-warez?dir=blender
- •
- Resolve an indirect flakeref with a branch override:
# nix registry resolve nixpkgs/25.05 github:NixOS/nixpkgs/25.05
Description
This command resolves indirect flakerefs (e.g. nixpkgs) to direct flakerefs (e.g. github:NixOS/nixpkgs) using the flake registries. It looks up each provided flakeref in all available registries (flag, user, system, and global) and returns the resolved direct flakeref on a separate line on standard output. It does not fetch any flakes.
The resolution process may apply multiple redirections if necessary until a direct flakeref is found. If an indirect flakeref cannot be found in any registry, an error will be thrown.
See the nix registry manual page for more details on the registry.
Options
Logging-related options
- •
- --debug
- Set the logging verbosity level to ‘debug’.
- •
- --log-format format
- Set the format of log output; one of raw, internal-json, bar or bar-with-logs.
- •
- --print-build-logs / -L
- Print full build logs on standard error.
- •
- --quiet
- Decrease the logging verbosity level.
- •
- --verbose / -v
- Increase the logging verbosity level.
Miscellaneous global options
- •
- --help
- Show usage information.
- Disable substituters and consider all previously downloaded files up-to-date.
- •
- --option name value
- Set the Nix configuration setting name to value (overriding nix.conf).
- Consider all previously downloaded files out-of-date.
- Show version information.
Note
See man nix.conf for overriding configuration settings with command line flags.