nix3-registry-resolve - Man Page

resolve flake references using the registry

Warning
This program is experimental and its interface is subject to change.

Synopsis

nix registry resolve [option…] flake-refs…

Examples

# nix registry resolve nixpkgs blender-bin
github:NixOS/nixpkgs/nixpkgs-unstable
github:edolstra/nix-warez?dir=blender
# 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

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.