dnf.plugin.system-upgrade man page

dnf system-upgrade — upgrade a system to a new major release


dnf system-upgrade download --releasever VERSION [Options]
dnf system-upgrade reboot
dnf system-upgrade clean
dnf system-upgrade log [NUMBER]


dnf system-upgrade can be used to upgrade a Fedora system to a new major release. It replaces fedup (the old Fedora Upgrade tool); for backward compatibility it accepts fedup command-line options whenever possible.

dnf system-upgrade accepts the following commands:

Downloads everything needed to upgrade to a new major release.
Prepares the system to perform the upgrade, and reboots to start the upgrade. This can only be used after the download command completes successfully.
Remove previously-downloaded data. This happens automatically at the end of a successful upgrade.
Used to see a list of boots during which an upgrade was attempted, or show the logs from an upgrade attempt. The logs for one of the boots can be shown by specifying one of the numbers in the first column. Negative numbers can be used to number the boots from last to first. For example, log -1 can be used to see the logs for the last upgrade attempt.


REQUIRED. The version to upgrade to. Sets $releasever in all enabled repos. Usually a number, or rawhide.
Behave like dnf distro-sync: always install packages from the new release, even if they are older than the currently-installed version. This is the default behavior.
Behave like dnf update: do not install packages from the new release if they are older than what is currently installed. This is the opposite of --distro-sync. If both are specified, the last option will be used.
Save downloaded packages to DIRECTORY. DIRECTORY must already exist. This directory must be mounted automatically by the system or the upgrade will not work. The default is /var/lib/dnf/system-update.


The fedup command is provided as a convenience; it is essentially just an alias for dnf system-upgrade.

dnf system-upgrade reboot does not create a "System Upgrade" boot item. The upgrade will start regardless of which boot item is chosen.

Since this is a DNF plugin, options accepted by dnf are also valid here. See dnf(8) for more information.


Upgrading from install media (e.g. a DVD or .iso file) currently requires the user to manually set up a DNF repo and fstab entry for the media.


Typical upgrade usage

dnf system-upgrade download --releasever 23
dnf system-upgrade reboot

Show logs from last upgrade attempt

dnf system-upgrade log -1

Reporting Bugs

Bugs should be filed here:


For more info on filing bugs, see the Fedora Project wiki:


Please include /var/log/dnf.log and the output of dnf system-upgrade log -1 (if applicable) in your bug reports.

Problems with dependency solving during download are best reported to the maintainers of the package(s) with the dependency problems.

Similarly, problems encountered on your system after the upgrade completes should be reported to the maintainers of the affected components. In other words: if (for example) KDE stops working, it's best if you report that to the KDE maintainers.

See Also

dnf(8), dnf.conf(5), journalctl(1)

Project homepage



Will Woods <wwoods@redhat.com>

Referenced By


Explore man page connections for dnf.plugin.system-upgrade(8).

0.7.1 October 21, 2015