System-Upgrade Command
Synopsis
dnf5 system-upgrade <subcommand> [options]
Description
The system-upgrade
command is used to upgrade the system to a new major release. First, the download
subcommand downloads packages while the system is running normally. Then, the reboot
subcommand reboots the system into a minimal “offline” environment to apply the upgrades.
dnf5 system-upgrade
is a recommended way to upgrade a system to a new major release. Before you proceed, ensure that your system is fully upgraded (dnf5 --refresh upgrade
).
system-upgrade
shares many subcommands with the offline subcommand.
Subcommands
clean
- See dnf5-offline(8), Offline command
download
- Downloads all packages needed to upgrade to a new major release and checks that they can be installed.
log
- See dnf5-offline(8), Offline command
reboot
- See dnf5-offline(8), Offline command
Options
--releasever=<version>
- Required. The version to upgrade to. Sets
$releasever
in all enabled repos. Usually a number, orrawhide
. --no-downgrade
- Behave like
dnf5 update
: 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 likednf5 distro-sync
, always installing packages from the new release, even if they are older than the currently-installed version. --number=<boot number>
- See dnf5-offline(8), Offline command
--poweroff
- See dnf5-offline(8), Offline command
Examples
Typical upgrade usage
dnf5 --refresh upgrade
dnf5 system-upgrade download --releasever 40
dnf5 system-upgrade reboot
Show logs from last upgrade attempt
dnf5 system-upgrade log --number=-1