Provided by: nix-bin_2.18.1+dfsg-1ubuntu5_amd64 
Name
nix upgrade-nix - upgrade Nix to the stable version declared in Nixpkgs
Synopsis
nix upgrade-nix [option…]
Examples
• Upgrade Nix to the stable version declared in Nixpkgs:
# nix upgrade-nix
• Upgrade Nix in a specific profile:
# nix upgrade-nix --profile ~alice/.local/state/nix/profiles/profile
Description
This command upgrades Nix to the stable version declared in Nixpkgs. This stable version is defined in
nix-fallback-paths.nix and updated manually. It may not always be the latest tagged release.
By default, it locates the directory containing the nix binary in the $PATH environment variable. If that
directory is a Nix profile, it will upgrade the nix package in that profile to the latest stable binary
release.
You cannot use this command to upgrade Nix in the system profile of a NixOS system (that is, if nix is
found in /run/current-system).
Options
• --dry-run
Show what this command would do without doing it.
• --nix-store-paths-url url
The URL of the file that contains the store paths of the latest Nix release.
• --profile / -p profile-dir
The path to the Nix profile to upgrade.
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 Nix configuration setting name to value (overriding nix.conf).
• --refresh
Consider all previously downloaded files out-of-date.
• --version
Show version information.
Options to override configuration settings:
• --accept-flake-config
Enable the accept-flake-config setting.
• --access-tokens value
Set the access-tokens setting.
• --allow-dirty
Enable the allow-dirty setting.
• --allow-import-from-derivation
Enable the allow-import-from-derivation setting.
• --allow-new-privileges
Enable the allow-new-privileges setting.
• --allow-symlinked-store
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 value
Set the allowed-impure-host-deps setting.
• --allowed-uris value
Set the allowed-uris setting.
• --allowed-users value
Set the allowed-users setting.
• --auto-allocate-uids
Enable the auto-allocate-uids setting.
• --auto-optimise-store
Enable the auto-optimise-store setting.
• --bash-prompt value
Set the bash-prompt setting.
• --bash-prompt-prefix value
Set the bash-prompt-prefix setting.
• --bash-prompt-suffix value
Set the bash-prompt-suffix setting.
• --build-hook value
Set the build-hook setting.
• --build-poll-interval value
Set the build-poll-interval setting.
• --build-users-group value
Set the build-users-group setting.
• --builders value
Set the builders setting.
• --builders-use-substitutes
Enable the builders-use-substitutes setting.
• --commit-lockfile-summary value
Set the commit-lockfile-summary setting.
• --compress-build-log
Enable the compress-build-log setting.
• --connect-timeout value
Set the connect-timeout setting.
• --cores value
Set the cores setting.
• --diff-hook value
Set the diff-hook setting.
• --download-attempts value
Set the download-attempts setting.
• --download-speed value
Set the download-speed setting.
• --eval-cache
Enable the eval-cache setting.
• --experimental-features value
Set the experimental-features setting.
• --extra-access-tokens value
Append to the access-tokens setting.
• --extra-allowed-impure-host-deps value
Append to the allowed-impure-host-deps setting.
• --extra-allowed-uris value
Append to the allowed-uris setting.
• --extra-allowed-users value
Append to the allowed-users setting.
• --extra-build-hook value
Append to the build-hook setting.
• --extra-experimental-features value
Append to the experimental-features setting.
• --extra-extra-platforms value
Append to the extra-platforms setting.
• --extra-hashed-mirrors value
Append to the hashed-mirrors setting.
• --extra-ignored-acls value
Append to the ignored-acls setting.
• --extra-nix-path value
Append to the nix-path setting.
• --extra-platforms value
Set the extra-platforms setting.
• --extra-plugin-files value
Append to the plugin-files setting.
• --extra-sandbox-paths value
Append to the sandbox-paths setting.
• --extra-secret-key-files value
Append to the secret-key-files setting.
• --extra-substituters value
Append to the substituters setting.
• --extra-system-features value
Append to the system-features setting.
• --extra-trusted-public-keys value
Append to the trusted-public-keys setting.
• --extra-trusted-substituters value
Append to the trusted-substituters setting.
• --extra-trusted-users value
Append to the trusted-users setting.
• --fallback
Enable the fallback setting.
• --filter-syscalls
Enable the filter-syscalls setting.
• --flake-registry value
Set the flake-registry setting.
• --fsync-metadata
Enable the fsync-metadata setting.
• --gc-reserved-space value
Set the gc-reserved-space setting.
• --hashed-mirrors value
Set the hashed-mirrors setting.
• --http-connections value
Set the http-connections setting.
• --http2
Enable the http2 setting.
• --id-count value
Set the id-count setting.
• --ignore-try
Enable the ignore-try setting.
• --ignored-acls value
Set the ignored-acls setting.
• --impersonate-linux-26
Enable the impersonate-linux-26 setting.
• --keep-build-log
Enable the keep-build-log setting.
• --keep-derivations
Enable the keep-derivations setting.
• --keep-env-derivations
Enable the keep-env-derivations setting.
• --keep-failed
Enable the keep-failed setting.
• --keep-going
Enable the keep-going setting.
• --keep-outputs
Enable the keep-outputs setting.
• --log-lines value
Set the log-lines setting.
• --max-build-log-size value
Set the max-build-log-size setting.
• --max-free value
Set the max-free setting.
• --max-jobs value
Set the max-jobs setting.
• --max-silent-time value
Set the max-silent-time setting.
• --max-substitution-jobs value
Set the max-substitution-jobs setting.
• --min-free value
Set the min-free setting.
• --min-free-check-interval value
Set the min-free-check-interval setting.
• --nar-buffer-size value
Set the nar-buffer-size setting.
• --narinfo-cache-negative-ttl value
Set the narinfo-cache-negative-ttl setting.
• --narinfo-cache-positive-ttl value
Set the narinfo-cache-positive-ttl setting.
• --netrc-file value
Set the netrc-file setting.
• --nix-path value
Set the nix-path setting.
• --no-accept-flake-config
Disable the accept-flake-config setting.
• --no-allow-dirty
Disable the allow-dirty setting.
• --no-allow-import-from-derivation
Disable the allow-import-from-derivation setting.
• --no-allow-new-privileges
Disable the allow-new-privileges setting.
• --no-allow-symlinked-store
Disable the allow-symlinked-store setting.
• --no-allow-unsafe-native-code-during-evaluation
Disable the allow-unsafe-native-code-during-evaluation setting.
• --no-auto-allocate-uids
Disable the auto-allocate-uids setting.
• --no-auto-optimise-store
Disable the auto-optimise-store setting.
• --no-builders-use-substitutes
Disable the builders-use-substitutes setting.
• --no-compress-build-log
Disable the compress-build-log setting.
• --no-eval-cache
Disable the eval-cache setting.
• --no-fallback
Disable the fallback setting.
• --no-filter-syscalls
Disable the filter-syscalls setting.
• --no-fsync-metadata
Disable the fsync-metadata setting.
• --no-http2
Disable the http2 setting.
• --no-ignore-try
Disable the ignore-try setting.
• --no-impersonate-linux-26
Disable the impersonate-linux-26 setting.
• --no-keep-build-log
Disable the keep-build-log setting.
• --no-keep-derivations
Disable the keep-derivations setting.
• --no-keep-env-derivations
Disable the keep-env-derivations setting.
• --no-keep-failed
Disable the keep-failed setting.
• --no-keep-going
Disable the keep-going setting.
• --no-keep-outputs
Disable the keep-outputs setting.
• --no-preallocate-contents
Disable the preallocate-contents setting.
• --no-print-missing
Disable the print-missing setting.
• --no-pure-eval
Disable the pure-eval setting.
• --no-require-drop-supplementary-groups
Disable the require-drop-supplementary-groups setting.
• --no-require-sigs
Disable the require-sigs setting.
• --no-restrict-eval
Disable the restrict-eval setting.
• --no-run-diff-hook
Disable the run-diff-hook setting.
• --no-sandbox
Disable sandboxing.
• --no-sandbox-fallback
Disable the sandbox-fallback setting.
• --no-show-trace
Disable the show-trace setting.
• --no-substitute
Disable the substitute setting.
• --no-sync-before-registering
Disable the sync-before-registering setting.
• --no-trace-function-calls
Disable the trace-function-calls setting.
• --no-trace-verbose
Disable the trace-verbose setting.
• --no-use-case-hack
Disable the use-case-hack setting.
• --no-use-cgroups
Disable the use-cgroups setting.
• --no-use-registries
Disable the use-registries setting.
• --no-use-sqlite-wal
Disable the use-sqlite-wal setting.
• --no-use-xdg-base-directories
Disable the use-xdg-base-directories setting.
• --no-warn-dirty
Disable the warn-dirty setting.
• --plugin-files value
Set the plugin-files setting.
• --post-build-hook value
Set the post-build-hook setting.
• --pre-build-hook value
Set the pre-build-hook setting.
• --preallocate-contents
Enable the preallocate-contents setting.
• --print-missing
Enable the print-missing setting.
• --pure-eval
Enable the pure-eval setting.
• --relaxed-sandbox
Enable sandboxing, but allow builds to disable it.
• --require-drop-supplementary-groups
Enable the require-drop-supplementary-groups setting.
• --require-sigs
Enable the require-sigs setting.
• --restrict-eval
Enable the restrict-eval setting.
• --run-diff-hook
Enable the run-diff-hook setting.
• --sandbox
Enable sandboxing.
• --sandbox-build-dir value
Set the sandbox-build-dir setting.
• --sandbox-dev-shm-size value
Set the sandbox-dev-shm-size setting.
• --sandbox-fallback
Enable the sandbox-fallback setting.
• --sandbox-paths value
Set the sandbox-paths setting.
• --secret-key-files value
Set the secret-key-files setting.
• --show-trace
Enable the show-trace setting.
• --ssl-cert-file value
Set the ssl-cert-file setting.
• --stalled-download-timeout value
Set the stalled-download-timeout setting.
• --start-id value
Set the start-id setting.
• --store value
Set the store setting.
• --substitute
Enable the substitute setting.
• --substituters value
Set the substituters setting.
• --sync-before-registering
Enable the sync-before-registering setting.
• --system value
Set the system setting.
• --system-features value
Set the system-features setting.
• --tarball-ttl value
Set the tarball-ttl setting.
• --timeout value
Set the timeout setting.
• --trace-function-calls
Enable the trace-function-calls setting.
• --trace-verbose
Enable the trace-verbose setting.
• --trusted-public-keys value
Set the trusted-public-keys setting.
• --trusted-substituters value
Set the trusted-substituters setting.
• --trusted-users value
Set the trusted-users setting.
• --use-case-hack
Enable the use-case-hack setting.
• --use-cgroups
Enable the use-cgroups setting.
• --use-registries
Enable the use-registries setting.
• --use-sqlite-wal
Enable the use-sqlite-wal setting.
• --use-xdg-base-directories
Enable the use-xdg-base-directories setting.
• --user-agent-suffix value
Set the user-agent-suffix setting.
• --warn-dirty
Enable the warn-dirty setting.
nix3-upgrade-nix(1)