Warning
This program is experimental and its interface is subject to change.
Name
nix store prefetch-file
- download a file into the Nix store
Synopsis
nix store prefetch-file
[option...] url
Examples
-
Download a file to the Nix store:
# nix store prefetch-file https://releases.nixos.org/nix/nix-2.3.10/nix-2.3.10.tar.xz Downloaded 'https://releases.nixos.org/nix/nix-2.3.10/nix-2.3.10.tar.xz' to '/nix/store/vbdbi42hgnc4h7pyqzp6h2yf77kw93aw-source' (hash 'sha256-qKheVd5D0BervxMDbt+1hnTKE2aRWC8XCAwc0SeHt6s=').
-
Download a file and get the SHA-512 hash:
# nix store prefetch-file --json --hash-type sha512 \ https://releases.nixos.org/nix/nix-2.3.10/nix-2.3.10.tar.xz \ | jq -r .hash sha512-6XJxfym0TNH9knxeH4ZOvns6wElFy3uahunl2hJgovACCMEMXSy42s69zWVyGJALXTI+86tpDJGlIcAySEKBbA==
Description
This command downloads the file url to the Nix store. It prints out the resulting store path and the cryptographic hash of the contents of the file.
The name component of the store path defaults to the last component of
url, but this can be overridden using --name
.
Options
-
Make the resulting file executable. Note that this causes the resulting hash to be a NAR hash rather than a flat file hash.
-
--expected-hash
hashThe expected hash of the file.
-
--hash-type
hash-algohash algorithm ('md5', 'sha1', 'sha256', or 'sha512')
-
Produce output in JSON format, suitable for consumption by another program.
-
--name
nameOverride the name component of the resulting store path. It defaults to the base name of url.
Logging-related options:
-
Set the logging verbosity level to 'debug'.
-
--log-format
formatSet the format of log output; one of
raw
,internal-json
,bar
orbar-with-logs
. -
--print-build-logs
/-L
Print full build logs on standard error.
-
Decrease the logging verbosity level.
-
--verbose
/-v
Increase the logging verbosity level.
Miscellaneous global options:
-
Show usage information.
-
Disable substituters and consider all previously downloaded files up-to-date.
-
--option
name valueSet the Nix configuration setting name to value (overriding
nix.conf
). -
Consider all previously downloaded files out-of-date.
-
Show version information.
Options to override configuration settings:
-
Enable the
accept-flake-config
setting. -
--access-tokens
valueSet the
access-tokens
setting. -
Enable the
allow-dirty
setting. -
--allow-import-from-derivation
Enable the
allow-import-from-derivation
setting. -
Enable the
allow-new-privileges
setting. -
Enable the
allow-symlinked-store
setting. -
--allow-unsafe-native-code-during-evaluation
Enable the
allow-unsafe-native-code-during-evaluation
setting. -
--allowed-impure-host-deps
valueSet the
allowed-impure-host-deps
setting. -
--allowed-uris
valueSet the
allowed-uris
setting. -
--allowed-users
valueSet the
allowed-users
setting. -
Enable the
auto-allocate-uids
setting. -
Enable the
auto-optimise-store
setting. -
--bash-prompt
valueSet the
bash-prompt
setting. -
--bash-prompt-prefix
valueSet the
bash-prompt-prefix
setting. -
--bash-prompt-suffix
valueSet the
bash-prompt-suffix
setting. -
--build-hook
valueSet the
build-hook
setting. -
--build-poll-interval
valueSet the
build-poll-interval
setting. -
--build-users-group
valueSet the
build-users-group
setting. -
--builders
valueSet the
builders
setting. -
Enable the
builders-use-substitutes
setting. -
--commit-lockfile-summary
valueSet the
commit-lockfile-summary
setting. -
Enable the
compress-build-log
setting. -
--connect-timeout
valueSet the
connect-timeout
setting. -
--cores
valueSet the
cores
setting. -
--diff-hook
valueSet the
diff-hook
setting. -
--download-attempts
valueSet the
download-attempts
setting. -
--download-speed
valueSet the
download-speed
setting. -
Enable the
eval-cache
setting. -
--experimental-features
valueSet the
experimental-features
setting. -
--extra-access-tokens
valueAppend to the
access-tokens
setting. -
--extra-allowed-impure-host-deps
valueAppend to the
allowed-impure-host-deps
setting. -
--extra-allowed-uris
valueAppend to the
allowed-uris
setting. -
--extra-allowed-users
valueAppend to the
allowed-users
setting. -
--extra-build-hook
valueAppend to the
build-hook
setting. -
--extra-experimental-features
valueAppend to the
experimental-features
setting. -
--extra-extra-platforms
valueAppend to the
extra-platforms
setting. -
--extra-hashed-mirrors
valueAppend to the
hashed-mirrors
setting. -
--extra-ignored-acls
valueAppend to the
ignored-acls
setting. -
--extra-nix-path
valueAppend to the
nix-path
setting. -
--extra-platforms
valueSet the
extra-platforms
setting. -
--extra-plugin-files
valueAppend to the
plugin-files
setting. -
--extra-sandbox-paths
valueAppend to the
sandbox-paths
setting. -
--extra-secret-key-files
valueAppend to the
secret-key-files
setting. -
--extra-substituters
valueAppend to the
substituters
setting. -
--extra-system-features
valueAppend to the
system-features
setting. -
--extra-trusted-public-keys
valueAppend to the
trusted-public-keys
setting. -
--extra-trusted-substituters
valueAppend to the
trusted-substituters
setting. -
--extra-trusted-users
valueAppend to the
trusted-users
setting. -
Enable the
fallback
setting. -
Enable the
filter-syscalls
setting. -
--flake-registry
valueSet the
flake-registry
setting. -
Enable the
fsync-metadata
setting. -
--gc-reserved-space
valueSet the
gc-reserved-space
setting. -
--hashed-mirrors
valueSet the
hashed-mirrors
setting. -
--http-connections
valueSet the
http-connections
setting. -
Enable the
http2
setting. -
--id-count
valueSet the
id-count
setting. -
Enable the
ignore-try
setting. -
--ignored-acls
valueSet the
ignored-acls
setting. -
Enable the
impersonate-linux-26
setting. -
Enable the
keep-build-log
setting. -
Enable the
keep-derivations
setting. -
Enable the
keep-env-derivations
setting. -
Enable the
keep-failed
setting. -
Enable the
keep-going
setting. -
Enable the
keep-outputs
setting. -
--log-lines
valueSet the
log-lines
setting. -
--max-build-log-size
valueSet the
max-build-log-size
setting. -
--max-free
valueSet the
max-free
setting. -
--max-jobs
valueSet the
max-jobs
setting. -
--max-silent-time
valueSet the
max-silent-time
setting. -
--max-substitution-jobs
valueSet the
max-substitution-jobs
setting. -
--min-free
valueSet the
min-free
setting. -
--min-free-check-interval
valueSet the
min-free-check-interval
setting. -
--nar-buffer-size
valueSet the
nar-buffer-size
setting. -
--narinfo-cache-negative-ttl
valueSet the
narinfo-cache-negative-ttl
setting. -
--narinfo-cache-positive-ttl
valueSet the
narinfo-cache-positive-ttl
setting. -
--netrc-file
valueSet the
netrc-file
setting. -
--nix-path
valueSet the
nix-path
setting. -
Disable the
accept-flake-config
setting. -
Disable the
allow-dirty
setting. -
--no-allow-import-from-derivation
Disable the
allow-import-from-derivation
setting. -
Disable the
allow-new-privileges
setting. -
Disable the
allow-symlinked-store
setting. -
--no-allow-unsafe-native-code-during-evaluation
Disable the
allow-unsafe-native-code-during-evaluation
setting. -
Disable the
auto-allocate-uids
setting. -
Disable the
auto-optimise-store
setting. -
Disable the
builders-use-substitutes
setting. -
Disable the
compress-build-log
setting. -
Disable the
eval-cache
setting. -
Disable the
fallback
setting. -
Disable the
filter-syscalls
setting. -
Disable the
fsync-metadata
setting. -
Disable the
http2
setting. -
Disable the
ignore-try
setting. -
Disable the
impersonate-linux-26
setting. -
Disable the
keep-build-log
setting. -
Disable the
keep-derivations
setting. -
Disable the
keep-env-derivations
setting. -
Disable the
keep-failed
setting. -
Disable the
keep-going
setting. -
Disable the
keep-outputs
setting. -
Disable the
preallocate-contents
setting. -
Disable the
print-missing
setting. -
Disable the
pure-eval
setting. -
--no-require-drop-supplementary-groups
Disable the
require-drop-supplementary-groups
setting. -
Disable the
require-sigs
setting. -
Disable the
restrict-eval
setting. -
Disable the
run-diff-hook
setting. -
Disable sandboxing.
-
Disable the
sandbox-fallback
setting. -
Disable the
show-trace
setting. -
Disable the
substitute
setting. -
Disable the
sync-before-registering
setting. -
Disable the
trace-function-calls
setting. -
Disable the
trace-verbose
setting. -
Disable the
use-case-hack
setting. -
Disable the
use-cgroups
setting. -
Disable the
use-registries
setting. -
Disable the
use-sqlite-wal
setting. -
Disable the
use-xdg-base-directories
setting. -
Disable the
warn-dirty
setting. -
--plugin-files
valueSet the
plugin-files
setting. -
--post-build-hook
valueSet the
post-build-hook
setting. -
--pre-build-hook
valueSet the
pre-build-hook
setting. -
Enable the
preallocate-contents
setting. -
Enable the
print-missing
setting. -
Enable the
pure-eval
setting. -
Enable sandboxing, but allow builds to disable it.
-
--require-drop-supplementary-groups
Enable the
require-drop-supplementary-groups
setting. -
Enable the
require-sigs
setting. -
Enable the
restrict-eval
setting. -
Enable the
run-diff-hook
setting. -
Enable sandboxing.
-
--sandbox-build-dir
valueSet the
sandbox-build-dir
setting. -
--sandbox-dev-shm-size
valueSet the
sandbox-dev-shm-size
setting. -
Enable the
sandbox-fallback
setting. -
--sandbox-paths
valueSet the
sandbox-paths
setting. -
--secret-key-files
valueSet the
secret-key-files
setting. -
Enable the
show-trace
setting. -
--ssl-cert-file
valueSet the
ssl-cert-file
setting. -
--stalled-download-timeout
valueSet the
stalled-download-timeout
setting. -
--start-id
valueSet the
start-id
setting. -
--store
valueSet the
store
setting. -
Enable the
substitute
setting. -
--substituters
valueSet the
substituters
setting. -
Enable the
sync-before-registering
setting. -
--system
valueSet the
system
setting. -
--system-features
valueSet the
system-features
setting. -
--tarball-ttl
valueSet the
tarball-ttl
setting. -
--timeout
valueSet the
timeout
setting. -
Enable the
trace-function-calls
setting. -
Enable the
trace-verbose
setting. -
--trusted-public-keys
valueSet the
trusted-public-keys
setting. -
--trusted-substituters
valueSet the
trusted-substituters
setting. -
--trusted-users
valueSet the
trusted-users
setting. -
Enable the
use-case-hack
setting. -
Enable the
use-cgroups
setting. -
Enable the
use-registries
setting. -
Enable the
use-sqlite-wal
setting. -
Enable the
use-xdg-base-directories
setting. -
--user-agent-suffix
valueSet the
user-agent-suffix
setting. -
Enable the
warn-dirty
setting.