Skip to content

nix store ping

Test whether a store can be accessed.

Warning

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

Synopsis

nix store ping [option...]

Examples

  • Test whether connecting to a remote Nix store via SSH works:
## nix store ping --store ssh://mac1
  • Test whether a URL is a valid binary cache:
## nix store ping --store https://cache.nixos.org
  • Test whether the Nix daemon is up and running:
## nix store ping --store daemon

Description

This command tests whether a particular Nix store (specified by the argument --store url) can be accessed. What this means is dependent on the type of the store. For instance, for an SSH store it means that Lix can connect to the specified machine.

If the command succeeds, Lix returns a exit code of 0 and does not print any output.

Options

  • --json Produce output in JSON format, suitable for consumption by another program.

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