1DNF-SYSTEM-UPGRADE(8) dnf-plugins-core DNF-SYSTEM-UPGRADE(8)
2
6 dnf-system-upgrade - DNF system-upgrade Plugin
7
9 DNF system-upgrades plugin provides three commands: system-upgrade,
10 offline-upgrade, and offline-distrosync. Only system-upgrade command
11 requires increase of distribution major version (--releasever) compared
12 to installed version.
13 dnf system-upgrade is a recommended way to upgrade a system to a new
15 major release. It replaces fedup (the old Fedora Upgrade tool). Before
16 you proceed ensure that your system is fully upgraded (dnf --refresh
17 upgrade).
18 The system-upgrade command also performes additional actions necessary
20 for the upgrade of the system, for example an upgrade of groups and en‐
21 vironments.
22
24 dnf system-upgrade download --releasever VERSION [OPTIONS]
25 dnf system-upgrade reboot
27 dnf system-upgrade reboot --poweroff
29 dnf system-upgrade clean
31 dnf system-upgrade log
33 dnf system-upgrade log --number=<number>
35 dnf offline-upgrade download [OPTIONS]
37 dnf offline-upgrade reboot
39 dnf offline-upgrade reboot --poweroff
41 dnf offline-upgrade clean
43 dnf offline-upgrade log
45 dnf offline-upgrade log --number=<number>
47 dnf offline-distrosync download [OPTIONS]
49 dnf offline-distrosync reboot
51 dnf offline-distrosync reboot --poweroff
53 dnf offline-distrosync clean
55 dnf offline-distrosync log
57 dnf offline-distrosync log --number=<number>
59
61 download
62 Downloads everything needed to upgrade to a new major release.
63 reboot Prepares the system to perform the upgrade, and reboots to start
65 the upgrade. This can only be used after the download command
66 completes successfully.
67 clean Remove previously-downloaded data. This happens automatically at
69 the end of a successful upgrade.
70 log Used to see a list of boots during which an upgrade was at‐
72 tempted, or show the logs from an upgrade attempt. The logs for
73 one of the boots can be shown by specifying one of the numbers
74 in the first column. Negative numbers can be used to number the
75 boots from last to first. For example, log --number=-1 can be
76 used to see the logs for the last upgrade attempt.
77
79 --releasever=VERSION
80 REQUIRED. The version to upgrade to. Sets $releasever in all en‐
81 abled repos. Usually a number, or rawhide.
82 --downloaddir=<path>
84 Redirect download of packages to provided <path>. By default,
85 packages are downloaded into (per repository created) subdirec‐
86 tories of /var/lib/dnf/system-upgrade.
87 --distro-sync
89 Behave like dnf distro-sync: always install packages from the
90 new release, even if they are older than the currently-installed
91 version. This is the default behavior.
92 --no-downgrade
94 Behave like dnf update: do not install packages from the new re‐
95 lease if they are older than what is currently installed. This
96 is the opposite of --distro-sync. If both are specified, the
97 last option will be used. The option cannot be used with the
98 offline-distrosync command.
99 --poweroff
101 When applied with the reboot subcommand, the system will power
102 off after upgrades are completed, instead of restarting.
103 --number
105 Applied with log subcommand will show the log specified by the
106 number.
107
109 dnf system-upgrade reboot does not create a "System Upgrade" boot item.
110 The upgrade will start regardless of which boot item is chosen.
111 The DNF_SYSTEM_UPGRADE_NO_REBOOT environment variable can be set to a
113 non-empty value to disable the actual reboot performed by system-up‐
114 grade (e.g. for testing purposes).
115 Since this is a DNF plugin, options accepted by dnf are also valid
117 here, such as --allowerasing. See dnf(8) for more information.
118 The fedup command is not provided, not even as an alias for dnf sys‐
120 tem-upgrade.
121
123 Upgrading from install media (e.g. a DVD or .iso file) currently re‐
124 quires the user to manually set up a DNF repo and fstab entry for the
125 media.
126
128 Typical upgrade usage
129 dnf --refresh upgrade
130 dnf system-upgrade download --releasever 26
132 dnf system-upgrade reboot
134 Show logs from last upgrade attempt
136 dnf system-upgrade log --number=-1
137
139 Bugs should be filed here:
140 https://bugzilla.redhat.com/
141 For more info on filing bugs, see the Fedora Project wiki:
143 https://fedoraproject.org/wiki/How_to_file_a_bug_report
144 https://fedoraproject.org/wiki/Bugs_and_feature_requests
146 Please include /var/log/dnf.log and the output of dnf system-upgrade
148 log --number=-1 (if applicable) in your bug reports.
149 Problems with dependency solving during download are best reported to
151 the maintainers of the package(s) with the dependency problems.
152 Similarly, problems encountered on your system after the upgrade com‐
154 pletes should be reported to the maintainers of the affected compo‐
155 nents. In other words: if (for example) KDE stops working, it's best if
156 you report that to the KDE maintainers.
157
159 dnf(8), dnf.conf(5), journalctl(1).
160 Project homepage
162 https://github.com/rpm-software-management/dnf-plugins-core
163
165 Will Woods <wwoods@redhat.com>
166 Štěpán Smetana <ssmetana@redhat.com>
168
170 See AUTHORS in your Core DNF Plugins distribution
171
173 2023, Red Hat, Licensed under GPLv2+
1744.4.3 Oct 06, 2023 DNF-SYSTEM-UPGRADE(8)