Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-install.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-INSTALL" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-install \- Install Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 install [options] <package\-spec\-NPFB>|@<group\-spec>|@<environment\-spec>...\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBinstall\fP command in \fBDNF5\fP is used for installing packages, groups or environments.
39 .sp
40 When installing packages defined in \fBpackage\-spec\-NPFB\fP arguments, \fBDNF5\fP ensures that the packages
41 and their dependencies are installed on the system.
42 If the specified packages are already installed, DNF5 does not check their dependencies again and
43 simply verifies that the packages themselves are present.
44 .sp
45 When \fBpackage\-spec\-NPFB\fP to specify the exact version of the package is given, DNF will install the
46 desired version, no matter which version of the package is already installed. The former version of
47 the package will be removed in the case of non\-installonly package.
48 .sp
49 On the other hand if \fBpackage\-spec\-NPFB\fP specifies only a name and obsoletes are enabled, DNF also
50 takes into account packages obsoleting that name.
51 Note that this can lead to seemingly unexpected results if the version of an installed package is obsoleted
52 and the installed package also has newer version available. It creates a split in upgrade\-path and both ways
53 are considered correct, the resulting package is picked simply by lexicographical order.
54 .sp
55 When installing groups defined in \fBgroup\-spec\fP arguments, \fBDNF5\fP ensures that the groups and
56 their packages are installed on the system. Installs only group packages matching configured package
57 type. See \fBdnf5.conf(5)\fP, \fI\%group_package_types\fP\&.
58 .sp
59 When installing environments defined in \fBenvironment\-spec\fP arguments, \fBDNF5\fP ensures that the
60 environments and their groups are installed on the system.
61 .SH OPTIONS
62 .INDENT 0.0
63 .TP
64 .B \fB\-\-allowerasing\fP
65 .nf
66 Allow removing of installed packages to resolve any potential dependency problems.
67 .fi
68 .sp
69 .TP
70 .B \fB\-\-skip\-broken\fP
71 .nf
72 Resolve any dependency problems by removing packages that are causing problems from the transaction.
73 .fi
74 .sp
75 .TP
76 .B \fB\-\-skip\-unavailable\fP
77 .nf
78 Allow skipping packages that are not available in repositories. All available packages will be installed.
79 .fi
80 .sp
81 .TP
82 .B \fB\-\-allow\-downgrade\fP
83 .nf
84 Enable downgrade of dependencies when resolving the requested operation.
85 .fi
86 .sp
87 .TP
88 .B \fB\-\-no\-allow\-downgrade\fP
89 .nf
90 Disable downgrade of dependencies when resolving the requested operation.
91 .fi
92 .sp
93 .UNINDENT
94 .INDENT 0.0
95 .TP
96 .B \fB\-\-from\-repo=REPO_ID,...\fP
97 .nf
98 Packages (or their provides) explicitly specified on the command line will only be looked up in the specified repositories.
99 These repositories are automatically enabled.
100 Repository enabling and disabling still applies. Dependencies of these packages will be resolved from any enabled repository.
101 .fi
102 .sp
103 .UNINDENT
104 .INDENT 0.0
105 .TP
106 .B \fB\-\-from\-vendor=VENDOR,...\fP
107 .nf
108 List of vendors separated by commas or spaces. Globs are supported (e.g., \fB\-\-from\-vendor=\(aqFedora\e project, vendorA, vendorB*, vendorC\(aq\fP).
109 Packages (or their provides) explicitly specified on the command line will only be looked up from the specified vendors.
110 The vendor change check is \fBbypassed\fP for these packages.
111 The vendor is ignored or vendor change policies (if \fBallow_vendor_change=0\fP) will still be used for packages that satisfy dependencies.
112 .fi
113 .sp
114 .UNINDENT
115 .INDENT 0.0
116 .TP
117 .B \fB\-\-downloadonly\fP
118 .nf
119 Download the resolved package set without executing an RPM transaction.
120 .fi
121 .sp
122 .UNINDENT
123 .INDENT 0.0
124 .TP
125 .B \fB\-\-offline\fP
126 .nf
127 Store the transaction to be performed offline. See \fI\%offline command\fP, \fBdnf5\-offline(8)\fP\&.
128 .fi
129 .sp
130 .TP
131 .B \fB\-\-store=PATH\fP
132 .nf
133 Store the current transaction in a directory at the specified \fBPATH\fP instead of running it.
134 The stored transaction can be performed by the \fI\%replay command\fP, \fBdnf5\-replay(8)\fP\&.
135 Note that repository ids in the stored transaction are mangled to \fB@stored_transaction(repo_id)\fP this is required
136 because during replaying the stored repositories are recreated and they might collide with already present repositories
137 (this doesn\(aqt apply to the special @System repository).
138 .fi
139 .sp
140 .UNINDENT
141 .INDENT 0.0
142 .TP
143 .B \fB\-\-advisories=ADVISORY_NAME,...\fP
144 .nf
145 Include content contained in advisories with specified name.
146 This is a list option.
147 Expected values are advisory IDs, e.g. \fIFEDORA\-2201\-123\fP\&.
148 Any transaction command (install, upgrade) will fail with an error if there is no existing advisory in the list; this can be bypassed by using the \-\-skip\-unavailable switch.
149 .fi
150 .sp
151 .UNINDENT
152 .INDENT 0.0
153 .TP
154 .B \fB\-\-advisory\-severities=ADVISORY_SEVERITY,...\fP
155 .nf
156 Include content contained in advisories with specified severity.
157 This is a list option.
158 Accepted values are: \fIcritical\fP, \fIimportant\fP, \fImoderate\fP, \fIlow\fP, \fInone\fP\&.
159 .fi
160 .sp
161 .UNINDENT
162 .INDENT 0.0
163 .TP
164 .B \fB\-\-bzs=BUGZILLA_ID,...\fP
165 .nf
166 Include content contained in advisories that fix a ticket of the given Bugzilla ID.
167 This is a list option.
168 Expected values are numeric IDs, e.g. \fI123123\fP\&.
169 Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the \-\-skip\-unavailable switch.
170 .fi
171 .sp
172 .UNINDENT
173 .INDENT 0.0
174 .TP
175 .B \fB\-\-cves=CVE_ID,...\fP
176 .nf
177 Include content contained in advisories that fix a ticket of the given CVE (Common Vulnerabilities and Exposures) ID.
178 This is a list option.
179 Expected values are string IDs in CVE format, e.g. \fICVE\-2201\-0123\fP\&.
180 Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the \-\-skip\-unavailable switch.
181 .fi
182 .sp
183 .UNINDENT
184 .INDENT 0.0
185 .TP
186 .B \fB\-\-security\fP
187 .nf
188 Include content contained in security advisories.
189 .fi
190 .sp
191 .UNINDENT
192 .INDENT 0.0
193 .TP
194 .B \fB\-\-bugfix\fP
195 .nf
196 Include content contained in bugfix advisories.
197 .fi
198 .sp
199 .UNINDENT
200 .INDENT 0.0
201 .TP
202 .B \fB\-\-enhancement\fP
203 .nf
204 Include content contained in enhancement advisories.
205 .fi
206 .sp
207 .UNINDENT
208 .INDENT 0.0
209 .TP
210 .B \fB\-\-newpackage\fP
211 .nf
212 Include content contained in newpackage advisories.
213 .fi
214 .sp
215 .UNINDENT
216 .SH EXAMPLES
217 .INDENT 0.0
218 .TP
219 .B \fBdnf5 install tito\fP
220 .nf
221 Install the \fBtito\fP package.
222 .fi
223 .sp
224 .TP
225 .B \fBdnf5 install ~/Downloads/tito\-0.6.21\-1.fc36.noarch.rpm\fP
226 .nf
227 Install the local rpm file from the given location.
228 .fi
229 .sp
230 .TP
231 .B \fBdnf5 install tito\-0.6.21\-1.fc36\fP
232 .nf
233 Install the \fBtito\fP package in defined version.
234 If the package is already installed, it will automatically try to downgrade or upgrade to the given version.
235 .fi
236 .sp
237 .TP
238 .B \fBdnf5 install \-\-advisory=FEDORA\-2022\-07aa56297a \e*\fP
239 .nf
240 Install all the packages that belong to the \fBFEDORA\-2022\-07aa56297a\fP advisory.
241 .fi
242 .sp
243 .UNINDENT
244 .SH SEE ALSO
245 .INDENT 0.0
246 .INDENT 3.5
247 .nf
248 \fBdnf5\-advisory(8)\fP, \fI\%Advisory command\fP
249 \fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP
250 .fi
251 .sp
252 .UNINDENT
253 .UNINDENT
254 .SH AUTHOR
255 See AUTHORS.md in dnf5 source distribution.
256 .SH COPYRIGHT
257 Contributors to the dnf5 project.
258 .\" Generated by docutils manpage writer.
259 .