Debian Codegraph @

upstream/debian-unstable/man8/dnf5-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 "DNF5-SYSTEM-UPGRADE" "8" "May 09, 2026" "" "dnf5"
32 .SH NAME
33 dnf5-system-upgrade \- System-Upgrade Command
34 .SH SYNOPSIS
35 .sp
36 \fBdnf5 system\-upgrade <subcommand> [options]\fP
37 .SH DESCRIPTION
38 .sp
39 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.
40 .sp
41 \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).
42 .sp
43 \fBsystem\-upgrade\fP shares many subcommands with the offline subcommand \%<#\:offline-command-ref-label>\&.
44 .SH SUBCOMMANDS
45 .INDENT 0.0
46 .TP
47 .B \fBclean\fP
48 .nf
49 See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
50 .fi
51 .sp
52 .TP
53 .B \fBdownload\fP
54 .nf
55 Downloads all packages needed to upgrade to a new major release and checks that they can be installed.
56 .fi
57 .sp
58 .TP
59 .B \fBlog\fP
60 .nf
61 See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
62 .fi
63 .sp
64 .TP
65 .B \fBreboot\fP
66 .nf
67 See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
68 .fi
69 .sp
70 .UNINDENT
71 .SH OPTIONS
72 .INDENT 0.0
73 .TP
74 .B \fB\-\-releasever=<version>\fP
75 .nf
76 Required. The version to upgrade to. Sets \fB$releasever\fP in all enabled repos. Usually a number, or \fBrawhide\fP\&.
77 .fi
78 .sp
79 .TP
80 .B \fB\-\-no\-downgrade\fP
81 .nf
82 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.
83 .fi
84 .sp
85 .TP
86 .B \fB\-\-allowerasing\fP
87 .nf
88 Allow removing of installed packages to resolve any potential dependency problems.
89 .fi
90 .sp
91 .TP
92 .B \fB\-\-number=<boot number>\fP
93 .nf
94 See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
95 .fi
96 .sp
97 .TP
98 .B \fB\-\-poweroff\fP
99 .nf
100 See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
101 .fi
102 .sp
103 .UNINDENT
104 .SH ENVIRONMENT
105 .sp
106 See \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>\&.
107 .SH EXAMPLES
108 .SS Typical upgrade usage
109 .sp
110 \fBdnf5 \-\-refresh upgrade\fP
111 .sp
112 \fBdnf5 system\-upgrade download \-\-releasever 40\fP
113 .sp
114 \fBdnf5 system\-upgrade reboot\fP
115 .SS Show logs from last upgrade attempt
116 .sp
117 \fBdnf5 system\-upgrade log \-\-number=\-1\fP
118 .SH SEE ALSO
119 .INDENT 0.0
120 .INDENT 3.5
121 .nf
122 \fBdnf5\-offline(8)\fP, Offline command \%<#\:offline-command-ref-label>
123 \%<https://\:www\:.freedesktop\:.org/\:wiki/\:Software/\:systemd/\:SystemUpdates>
124 .fi
125 .sp
126 .UNINDENT
127 .UNINDENT
128 .SH Author
129 See AUTHORS.md in dnf5 source distribution.
130 .SH Copyright
131 Contributors to the dnf5 project.
132 .\" End of generated man page.