.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-upgrade-nix" "1" ""
.RS
.PP
\fBWarning\fR 
.br
This program is
\fB\fBexperimental\fR\fR
and its interface is subject to change.
.RE
.SH Name
.LP
\f(CRnix upgrade-nix\fR - upgrade Nix to the latest stable version
.SH Synopsis
.LP
\f(CRnix upgrade-nix\fR [\fIoption\fR\[u2026]] 
.SH Examples
.IP "\(bu" 3
Upgrade Nix to the stable version declared in Nixpkgs:
.LP
.EX
# nix upgrade-nix
.EE
.IP "\(bu" 3
Upgrade Nix in a specific profile:
.LP
.EX
# nix upgrade-nix --profile \(tialice/.local/state/nix/profiles/profile
.EE
.SH Description
.LP
This command upgrades Nix to the stable version.
.PP
By default, the latest stable version is defined by Nixpkgs, in
\fBnix-fallback-paths.nix\fR
and updated manually. It may not always be the latest tagged release.
.PP
By default, it locates the directory containing the \f(CRnix\fR binary in the \f(CR$PATH\fR
environment variable. If that directory is a Nix profile, it will
upgrade the \f(CRnix\fR package in that profile to the latest stable binary
release.
.PP
You cannot use this command to upgrade Nix in the system profile of a
NixOS system (that is, if \f(CRnix\fR is found in \f(CR/run/current-system\fR).
.SH Options
.IP "\(bu" 3
\fB\f(CR--dry-run\fR\fR
.IP
Show what this command would do without doing it.
.IP "\(bu" 3
\fB\f(CR--nix-store-paths-url\fR\fR \fIurl\fR
.IP
The URL of the file that contains the store paths of the latest Nix release.
.IP "\(bu" 3
\fB\f(CR--profile\fR\fR / \f(CR-p\fR \fIprofile-dir\fR
.IP
The path to the Nix profile to upgrade.
.SS
Logging-related options
.IP "\(bu" 3
\fB\f(CR--debug\fR\fR
.IP
Set the logging verbosity level to \(oqdebug\(cq.
.IP "\(bu" 3
\fB\f(CR--log-format\fR\fR \fIformat\fR
.IP
Set the format of log output; one of \f(CRraw\fR, \f(CRinternal-json\fR, \f(CRbar\fR or \f(CRbar-with-logs\fR.
.IP "\(bu" 3
\fB\f(CR--print-build-logs\fR\fR / \f(CR-L\fR
.IP
Print full build logs on standard error.
.IP "\(bu" 3
\fB\f(CR--quiet\fR\fR
.IP
Decrease the logging verbosity level.
.IP "\(bu" 3
\fB\f(CR--verbose\fR\fR / \f(CR-v\fR
.IP
Increase the logging verbosity level.
.SS
Miscellaneous global options
.IP "\(bu" 3
\fB\f(CR--help\fR\fR
.IP
Show usage information.
.IP "\(bu" 3
\fB\f(CR--offline\fR\fR
.IP
Disable substituters and consider all previously downloaded files up-to-date.
.IP "\(bu" 3
\fB\f(CR--option\fR\fR \fIname\fR \fIvalue\fR
.IP
Set the Nix configuration setting \fIname\fR to \fIvalue\fR (overriding \f(CRnix.conf\fR).
.IP "\(bu" 3
\fB\f(CR--refresh\fR\fR
.IP
Consider all previously downloaded files out-of-date.
.IP "\(bu" 3
\fB\f(CR--version\fR\fR
.IP
Show version information.
.RS
.LP
\fBNote\fR
.PP
See \fB\f(CRman nix.conf\fR\fR for overriding configuration settings with command line flags.
.RE