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

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.