Reference

nix3-store(1)

manipulate a Nix store

Warning
This program is experimental ⟨@docroot@/development/experimental-features.md#xp-feature-nix-command⟩ and its interface is subject to change.

Name

nix store - manipulate a Nix store

Synopsis

nix store [option…] subcommand

where subcommand is one of the following:

•

nix store add ⟨./nix3-store-add.md⟩ - Add a file or directory to the Nix store

•

nix store add-file ⟨./nix3-store-add-file.md⟩ - Deprecated. Use nix store add --mode flat ⟨@docroot@/command-ref/new-cli/nix3-store-add.md⟩ instead.

•

nix store add-path ⟨./nix3-store-add-path.md⟩ - Deprecated alias to nix store add ⟨@docroot@/command-ref/new-cli/nix3-store-add.md⟩\c .

•

nix store cat ⟨./nix3-store-cat.md⟩ - print the contents of a file in the Nix store on stdout

•

nix store copy-log ⟨./nix3-store-copy-log.md⟩ - copy build logs between Nix stores

•

nix store copy-sigs ⟨./nix3-store-copy-sigs.md⟩ - copy store path signatures from substituters

•

nix store delete ⟨./nix3-store-delete.md⟩ - delete paths from the Nix store

•

nix store diff-closures ⟨./nix3-store-diff-closures.md⟩ - show what packages and versions were added and removed between two closures

•

nix store dump-path ⟨./nix3-store-dump-path.md⟩ - serialise a store path to stdout in NAR format

•

nix store gc ⟨./nix3-store-gc.md⟩ - perform garbage collection on a Nix store

•

nix store info ⟨./nix3-store-info.md⟩ - test whether a store can be accessed

•

nix store ls ⟨./nix3-store-ls.md⟩ - show information about a path in the Nix store

•

nix store make-content-addressed ⟨./nix3-store-make-content-addressed.md⟩ - rewrite a path or closure to content-addressed form

•

nix store optimise ⟨./nix3-store-optimise.md⟩ - replace identical files in the store by hard links

•

nix store path-from-hash-part ⟨./nix3-store-path-from-hash-part.md⟩ - get a store path from its hash part

•

nix store ping ⟨./nix3-store-ping.md⟩ - test whether a store can be accessed

•

nix store prefetch-file ⟨./nix3-store-prefetch-file.md⟩ - download a file into the Nix store

•

nix store repair ⟨./nix3-store-repair.md⟩ - repair store paths

•

nix store sign ⟨./nix3-store-sign.md⟩ - sign store paths with a local key

•

nix store verify ⟨./nix3-store-verify.md⟩ - verify the integrity of store paths

Options

Logging-related options

•

--debug ⟨#opt-debug⟩

Set the logging verbosity level to ‘debug’.

•

--log-format ⟨#opt-log-format⟩ format

Set the format of log output; one of raw, internal-json, bar or bar-with-logs.

•

--print-build-logs ⟨#opt-print-build-logs⟩ / -L

Print full build logs on standard error.

•

--quiet ⟨#opt-quiet⟩

Decrease the logging verbosity level.

•

--verbose ⟨#opt-verbose⟩ / -v

Increase the logging verbosity level.

Miscellaneous global options

•

--help ⟨#opt-help⟩

Show usage information.

•

--offline ⟨#opt-offline⟩

Disable substituters and consider all previously downloaded files up-to-date.

•

--option ⟨#opt-option⟩ name value

Set the Nix configuration setting name to value (overriding nix.conf).

•

--refresh ⟨#opt-refresh⟩

Consider all previously downloaded files out-of-date.

•

--version ⟨#opt-version⟩

Show version information.

Note

See man nix.conf ⟨@docroot@/command-ref/conf-file.md#command-line-flags⟩ for overriding configuration settings with command line flags.

History