Reference

nix3-nar-pack(1)

serialise a path to stdout in NAR format

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

Name

nix nar pack - serialise a path to stdout in NAR format

Synopsis

nix nar pack [option…] path

Examples

•

To serialise directory foo as a Nix Archive (NAR) ⟨@docroot@/store/file-system-object/content-address.md#serial-nix-archive⟩\c :

# nix nar pack ./foo > foo.nar

Description

This command generates a Nix Archive (NAR) ⟨@docroot@/store/file-system-object/content-address.md#serial-nix-archive⟩ file containing the serialisation of path, which must contain only regular files, directories and symbolic links. The NAR is written to standard output.

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.