Debian Codegraph @

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