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.

•   --offline

    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).

•   --refresh

    Consider all previously downloaded files out-of-date.

•   --version

    Show version information.

    Note

    See man nix.conf for overriding configuration settings with command line flags.