.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-upgrade-nix" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix upgrade-nix\fR - upgrade Nix to the latest stable version
.SH Synopsis
\fCnix upgrade-nix\fR [\fIoption\fR\[u2026]] 
.SH Examples
.IP "\(bu" 2
Upgrade Nix to the latest stable version:
.LP
.EX
# nix upgrade-nix
.EE
.IP "\(bu" 2
Upgrade Nix in a specific profile:
.LP
.EX
# nix upgrade-nix -p /nix/var/nix/profiles/per-user/alice/profile
.EE
.SH Description
This command upgrades Nix to the latest version. By default, it
locates the directory containing the \fCnix\fR binary in the \fC$PATH\fR
environment variable. If that directory is a Nix profile, it will
upgrade the \fCnix\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 \fCnix\fR is found in \fC/run/current-system\fR).
.SH Options
.IP "\(bu" 2
\fC--dry-run\fR
.br
Show what this command would do without doing it.
.IP "\(bu" 2
\fC--nix-store-paths-url\fR \fIurl\fR
.br
The URL of the file that contains the store paths of the latest Nix release.
.IP "\(bu" 2
\fC--profile\fR / \fC-p\fR \fIprofile-dir\fR
.br
The path to the Nix profile to upgrade.