Debian Codegraph @

upstream/fedora-44/man8/dnf4-system-upgrade.8

raw
1 .\" Man page generated from reStructuredText
2 .\" by the Docutils 0.22.4 manpage writer.
3 .
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .TH "DNF4-SYSTEM-UPGRADE" "8" "Feb 25, 2026" "4.10.1" "dnf-plugins-core"
32 .SH NAME
33 dnf4-system-upgrade \- DNF system-upgrade Plugin
34 .SH DESCRIPTION
35 .sp
36 DNF system\-upgrades plugin provides three commands: \fBsystem\-upgrade\fP, \fBoffline\-upgrade\fP, and
37 \fBoffline\-distrosync\fP\&. Only \fBsystem\-upgrade\fP command requires increase of distribution major
38 version (\fB\-\-releasever\fP) compared to installed version.
39 .sp
40 \fBdnf system\-upgrade\fP is a recommended way to upgrade a system to a new major release.
41 It replaces fedup (the old Fedora Upgrade tool). Before you proceed ensure that your system
42 is fully upgraded (\fBdnf \-\-refresh upgrade\fP).
43 .sp
44 The \fBsystem\-upgrade\fP command also performes additional actions necessary for the upgrade of the
45 system, for example an upgrade of groups and environments.
46 .SH SYNOPSIS
47 .sp
48 \fBdnf system\-upgrade download \-\-releasever VERSION [OPTIONS]\fP
49 .sp
50 \fBdnf system\-upgrade reboot\fP
51 .sp
52 \fBdnf system\-upgrade reboot \-\-poweroff\fP
53 .sp
54 \fBdnf system\-upgrade clean\fP
55 .sp
56 \fBdnf system\-upgrade log\fP
57 .sp
58 \fBdnf system\-upgrade log \-\-number=<number>\fP
59 .sp
60 \fBdnf offline\-upgrade download [OPTIONS]\fP
61 .sp
62 \fBdnf offline\-upgrade reboot\fP
63 .sp
64 \fBdnf offline\-upgrade reboot \-\-poweroff\fP
65 .sp
66 \fBdnf offline\-upgrade clean\fP
67 .sp
68 \fBdnf offline\-upgrade log\fP
69 .sp
70 \fBdnf offline\-upgrade log \-\-number=<number>\fP
71 .sp
72 \fBdnf offline\-distrosync download [OPTIONS]\fP
73 .sp
74 \fBdnf offline\-distrosync reboot\fP
75 .sp
76 \fBdnf offline\-distrosync reboot \-\-poweroff\fP
77 .sp
78 \fBdnf offline\-distrosync clean\fP
79 .sp
80 \fBdnf offline\-distrosync log\fP
81 .sp
82 \fBdnf offline\-distrosync log \-\-number=<number>\fP
83 .SH SUBCOMMANDS
84 .INDENT 0.0
85 .TP
86 .B \fBdownload\fP
87 Downloads everything needed to upgrade to a new major release.
88 .TP
89 .B \fBreboot\fP
90 Prepares the system to perform the upgrade, and reboots to start the upgrade.
91 This can only be used after the \fBdownload\fP command completes successfully.
92 .TP
93 .B \fBclean\fP
94 Remove previously\-downloaded data. This happens automatically at the end of
95 a successful upgrade.
96 .TP
97 .B \fBlog\fP
98 Used to see a list of boots during which an upgrade was attempted, or show
99 the logs from an upgrade attempt. The logs for one of the boots can be shown
100 by specifying one of the numbers in the first column. Negative numbers can
101 be used to number the boots from last to first. For example, \fBlog \-\-number=\-1\fP can
102 be used to see the logs for the last upgrade attempt.
103 .UNINDENT
104 .SH OPTIONS
105 .INDENT 0.0
106 .TP
107 .B \fB\-\-releasever=VERSION\fP
108 REQUIRED. The version to upgrade to. Sets \fB$releasever\fP in all enabled
109 repos. Usually a number, or \fBrawhide\fP\&.
110 .TP
111 .B \fB\-\-downloaddir=<path>\fP
112 Redirect download of packages to provided \fB<path>\fP\&. By default, packages
113 are downloaded into (per repository created) subdirectories of
114 /var/lib/dnf/system\-upgrade.
115 .TP
116 .B \fB\-\-distro\-sync\fP
117 Behave like \fBdnf distro\-sync\fP: always install packages from the new
118 release, even if they are older than the currently\-installed version. This
119 is the default behavior.
120 .TP
121 .B \fB\-\-no\-downgrade\fP
122 Behave like \fBdnf update\fP: do not install packages from the new release
123 if they are older than what is currently installed. This is the opposite of
124 \fB\-\-distro\-sync\fP\&. If both are specified, the last option will be used. The option cannot be
125 used with the \fBoffline\-distrosync\fP command.
126 .TP
127 .B \fB\-\-poweroff\fP
128 When applied with the \fBreboot\fP subcommand, the system will power off after
129 upgrades are completed, instead of restarting.
130 .TP
131 .B \fB\-\-number\fP
132 Applied with \fBlog\fP subcommand will show the log specified by the number.
133 .UNINDENT
134 .SH NOTES
135 .sp
136 \fBdnf system\-upgrade reboot\fP does not create a \(dqSystem Upgrade\(dq boot item. The
137 upgrade will start regardless of which boot item is chosen.
138 .sp
139 The \fBDNF_SYSTEM_UPGRADE_NO_REBOOT\fP environment variable can be set to a
140 non\-empty value to disable the actual reboot performed by \fBsystem\-upgrade\fP
141 (e.g. for testing purposes).
142 .sp
143 Since this is a DNF plugin, options accepted by \fBdnf\fP are also valid here,
144 such as \fB\-\-allowerasing\fP\&.
145 See \fBdnf(8)\fP for more information.
146 .sp
147 The \fBfedup\fP command is not provided, not even as an alias for
148 \fBdnf system\-upgrade\fP\&.
149 .SH BUGS
150 .sp
151 Upgrading from install media (e.g. a DVD or .iso file) currently requires the
152 user to manually set up a DNF repo and fstab entry for the media.
153 .SH EXAMPLES
154 .SS Typical upgrade usage
155 .sp
156 \fBdnf \-\-refresh upgrade\fP
157 .sp
158 \fBdnf system\-upgrade download \-\-releasever 26\fP
159 .sp
160 \fBdnf system\-upgrade reboot\fP
161 .SS Show logs from last upgrade attempt
162 .sp
163 \fBdnf system\-upgrade log \-\-number=\-1\fP
164 .SH REPORTING BUGS
165 .sp
166 Bugs should be filed here:
167 .INDENT 0.0
168 .INDENT 3.5
169 \%<https://\:bugzilla\:.redhat\:.com/>
170 .UNINDENT
171 .UNINDENT
172 .sp
173 For more info on filing bugs, see the Fedora Project wiki:
174 .INDENT 0.0
175 .INDENT 3.5
176 \%<https://\:fedoraproject\:.org/\:wiki/\:How_to_file_a_bug_report>
177 .sp
178 \%<https://\:fedoraproject\:.org/\:wiki/\:Bugs_and_feature_requests>
179 .UNINDENT
180 .UNINDENT
181 .sp
182 Please include \fB/var/log/dnf.log\fP and the output of
183 \fBdnf system\-upgrade log \-\-number=\-1\fP (if applicable) in your bug reports.
184 .sp
185 Problems with dependency solving during download are best reported to the
186 maintainers of the package(s) with the dependency problems.
187 .sp
188 Similarly, problems encountered on your system after the upgrade completes
189 should be reported to the maintainers of the affected components. In other
190 words: if (for example) KDE stops working, it\(aqs best if you report that to
191 the KDE maintainers.
192 .SH SEE ALSO
193 .sp
194 \fBdnf(8)\fP,
195 \fBdnf.conf(5)\fP,
196 \fBjournalctl(1)\fP\&.
197 .SS Project homepage
198 .sp
199 \%<https://\:github\:.com/\:rpm-software-management/\:dnf-plugins-core>
200 .SH AUTHORS
201 .sp
202 Will Woods <\%<wwoods@\:redhat\:.com>>
203 .sp
204 Štěpán Smetana <\%<ssmetana@\:redhat\:.com>>
205 .SH Author
206 See AUTHORS in your Core DNF Plugins distribution
207 .SH Copyright
208 2014, Red Hat, Licensed under GPLv2+
209 .\" End of generated man page.