.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "DNF5-SYSTEM-UPGRADE" "8" "May 06, 2026" "" "dnf5"
.SH NAME
dnf5-system-upgrade \- System-Upgrade Command
.SH SYNOPSIS
.sp
\fBdnf5 system\-upgrade <subcommand> [options]\fP
.SH DESCRIPTION
.sp
The \fBsystem\-upgrade\fP command is used to upgrade the system to a new major release. First, the \fBdownload\fP subcommand downloads packages while the system is running normally. Then, the \fBreboot\fP subcommand reboots the system into a minimal \(dqoffline\(dq environment to apply the upgrades.
.sp
\fBdnf5 system\-upgrade\fP is a recommended way to upgrade a system to a new major release. Before you proceed, ensure that your system is fully upgraded (\fBdnf5 \-\-refresh upgrade\fP).
.sp
\fBsystem\-upgrade\fP shares many subcommands with the offline subcommand \%<#\:offline-command-ref-label>\&.
.SH SUBCOMMANDS
.INDENT 0.0
.TP
.B \fBclean\fP
.nf
See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
.fi
.sp
.TP
.B \fBdownload\fP
.nf
Downloads all packages needed to upgrade to a new major release and checks that they can be installed.
.fi
.sp
.TP
.B \fBlog\fP
.nf
See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
.fi
.sp
.TP
.B \fBreboot\fP
.nf
See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
.fi
.sp
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-\-releasever=<version>\fP
.nf
Required. The version to upgrade to. Sets \fB$releasever\fP in all enabled repos. Usually a number, or \fBrawhide\fP\&.
.fi
.sp
.TP
.B \fB\-\-no\-downgrade\fP
.nf
Behave like \fBdnf5 update\fP: do not install packages from the new release if they are older than what is currently installed. This is the opposite of the default behavior, which behaves like \fBdnf5 distro\-sync\fP, always installing packages from the new release, even if they are older than the currently\-installed version.
.fi
.sp
.TP
.B \fB\-\-allowerasing\fP
.nf
Allow removing of installed packages to resolve any potential dependency problems.
.fi
.sp
.TP
.B \fB\-\-number=<boot number>\fP
.nf
See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
.fi
.sp
.TP
.B \fB\-\-poweroff\fP
.nf
See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
.fi
.sp
.UNINDENT
.SH ENVIRONMENT
.sp
See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>\&.
.SH EXAMPLES
.SS Typical upgrade usage
.sp
\fBdnf5 \-\-refresh upgrade\fP
.sp
\fBdnf5 system\-upgrade download \-\-releasever 40\fP
.sp
\fBdnf5 system\-upgrade reboot\fP
.SS Show logs from last upgrade attempt
.sp
\fBdnf5 system\-upgrade log \-\-number=\-1\fP
.SH SEE ALSO
.INDENT 0.0
.INDENT 3.5
.nf
\fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
\%<https://\:www\:.freedesktop\:.org/\:wiki/\:Software/\:systemd/\:SystemUpdates>
.fi
.sp
.UNINDENT
.UNINDENT
.SH Author
See AUTHORS.md in dnf5 source distribution.
.SH Copyright
Contributors to the dnf5 project.
.\" End of generated man page.
