Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-system-upgrade.8

raw
1 .\" Man page generated from reStructuredText.
2 .
3 .
4 .nr rst2man-indent-level 0
5 .
6 .de1 rstReportMargin
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
14 ..
15 .de1 INDENT
16 .\" .rstReportMargin pre:
17 . RS \\$1
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
20 .\" .rstReportMargin post:
21 ..
22 .de UNINDENT
23 . RE
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
29 ..
30 .TH "DNF5-SYSTEM-UPGRADE" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-system-upgrade \- System-Upgrade Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 system\-upgrade <subcommand> [options]\fP
36 .SH DESCRIPTION
37 .sp
38 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.
39 .sp
40 \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).
41 .sp
42 \fBsystem\-upgrade\fP shares many subcommands with the \fI\%offline subcommand\fP\&.
43 .SH SUBCOMMANDS
44 .INDENT 0.0
45 .TP
46 .B \fBclean\fP
47 .nf
48 See \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP
49 .fi
50 .sp
51 .TP
52 .B \fBdownload\fP
53 .nf
54 Downloads all packages needed to upgrade to a new major release and checks that they can be installed.
55 .fi
56 .sp
57 .TP
58 .B \fBlog\fP
59 .nf
60 See \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP
61 .fi
62 .sp
63 .TP
64 .B \fBreboot\fP
65 .nf
66 See \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP
67 .fi
68 .sp
69 .UNINDENT
70 .SH OPTIONS
71 .INDENT 0.0
72 .TP
73 .B \fB\-\-releasever=<version>\fP
74 .nf
75 Required. The version to upgrade to. Sets \fB$releasever\fP in all enabled repos. Usually a number, or \fBrawhide\fP\&.
76 .fi
77 .sp
78 .TP
79 .B \fB\-\-no\-downgrade\fP
80 .nf
81 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.
82 .fi
83 .sp
84 .TP
85 .B \fB\-\-allowerasing\fP
86 .nf
87 Allow removing of installed packages to resolve any potential dependency problems.
88 .fi
89 .sp
90 .TP
91 .B \fB\-\-number=<boot number>\fP
92 .nf
93 See \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP
94 .fi
95 .sp
96 .TP
97 .B \fB\-\-poweroff\fP
98 .nf
99 See \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP
100 .fi
101 .sp
102 .UNINDENT
103 .SH ENVIRONMENT
104 .sp
105 See \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP\&.
106 .SH EXAMPLES
107 .SS Typical upgrade usage
108 .sp
109 \fBdnf5 \-\-refresh upgrade\fP
110 .sp
111 \fBdnf5 system\-upgrade download \-\-releasever 40\fP
112 .sp
113 \fBdnf5 system\-upgrade reboot\fP
114 .SS Show logs from last upgrade attempt
115 .sp
116 \fBdnf5 system\-upgrade log \-\-number=\-1\fP
117 .SH SEE ALSO
118 .INDENT 0.0
119 .INDENT 3.5
120 .nf
121 \fBdnf5\-offline(8)\fP, \fI\%Offline command\fP
122 \X'tty: link https://www.freedesktop.org/wiki/Software/systemd/SystemUpdates'\fI\%https://www.freedesktop.org/wiki/Software/systemd/SystemUpdates\fP\X'tty: link'
123 .fi
124 .sp
125 .UNINDENT
126 .UNINDENT
127 .SH AUTHOR
128 See AUTHORS.md in dnf5 source distribution.
129 .SH COPYRIGHT
130 Contributors to the dnf5 project.
131 .\" Generated by docutils manpage writer.
132 .