Debian Codegraph @

upstream/mageia-cauldron/man5/dnf5.conf.5

raw
1 '\" t
2 .\" Man page generated from reStructuredText.
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.CONF" "5" "May 10, 2026" "" "dnf5"
32 .SH NAME
33 dnf5.conf \- DNF5 Configuration Reference
34 .SH DESCRIPTION
35 .sp
36 \fIDNF5\fP by default uses the global configuration file at /etc/dnf/dnf.conf.
37 .sp
38 The configuration file has INI format consisting of section declaration and name=value options below each on separate
39 line. There are two types of sections in the configuration files: main and repository. Main section defines all
40 global configuration options and should be only one.
41 .sp
42 The repository sections define the configuration for each (remote or local) repository. The section name of the
43 repository in brackets serve as repo ID reference and should be unique across configuration files. The allowed
44 characters of repo ID string are lower and upper case alphabetic letters, digits, \-, _, . and :. The minimal
45 repository configuration file should aside from repo ID consists of baseurl, metalink or mirrorlist option definition.
46 .SH [MAIN] OPTIONS
47 .INDENT 0.0
48 .TP
49 .B \fBallow_downgrade\fP
50 \fI\%boolean\fP
51 .sp
52 If enabled, DNF5 allows downgrading packages while resolving dependencies.
53 .sp
54 Default: \fBTrue\fP\&.
55 .UNINDENT
56 .INDENT 0.0
57 .TP
58 .B \fBallow_vendor_change\fP
59 \fI\%boolean\fP
60 .sp
61 If disabled, DNF5 will stick to the original vendor during RPM upgrades or downgrades.
62 This preference, however, can be fine\-tuned using \fI\%Vendor change policies\fP\&.
63 .sp
64 Default: \fBTrue\fP\&.
65 .sp
66 \fBWARNING:\fP
67 .INDENT 7.0
68 .INDENT 3.5
69 This option is currently not supported for \fIdowngrade\fP and \fIdistro\-sync\fP commands
70 .UNINDENT
71 .UNINDENT
72 .UNINDENT
73 .INDENT 0.0
74 .TP
75 .B \fBassumeno\fP
76 \fI\%boolean\fP
77 .sp
78 If enabled DNF5 will assume \fBNo\fP where it would normally prompt for confirmation from user input
79 .sp
80 Default: \fBFalse\fP\&.
81 .UNINDENT
82 .INDENT 0.0
83 .TP
84 .B \fBassumeyes\fP
85 \fI\%boolean\fP
86 .sp
87 If enabled DNF5 will assume \fBYes\fP where it would normally prompt for
88 confirmation from user input (see also \fI\%defaultyes\fP).
89 .sp
90 Default: \fBFalse\fP\&.
91 .UNINDENT
92 .INDENT 0.0
93 .TP
94 .B \fBbest\fP
95 \fI\%boolean\fP
96 .sp
97 If \fBTrue\fP, instructs the solver to either use a package with the highest
98 available version or fail. If \fBFalse\fP, do not fail if the latest version
99 cannot be installed and go with the lower version.
100 .sp
101 Default: \fBTrue\fP\&.
102 .sp
103 \fBNOTE:\fP
104 .INDENT 7.0
105 .INDENT 3.5
106 This option in particular can be set in your configuration file by
107 your distribution\&.
108 .UNINDENT
109 .UNINDENT
110 .UNINDENT
111 .INDENT 0.0
112 .TP
113 .B \fBcachedir\fP
114 \fI\%string\fP
115 .sp
116 Path to a directory used by various DNF5 subsystems for storing cache data
117 including repositories metadata and downloaded packages.
118 Has a reasonable root\-writable default depending on the distribution. DNF5
119 needs to be able to create files and directories at this location.
120 .sp
121 Regular user default: \fB~/.cache/libdnf5\fP\&.
122 .sp
123 For superuser the value is overwritten by system_cachedir option.
124 .UNINDENT
125 .INDENT 0.0
126 .TP
127 .B \fBcacheonly\fP
128 \fI\%string\fP
129 .sp
130 Can be \fBall\fP, \fBmetadata\fP, \fBnone\fP\&.
131 .sp
132 If set to \fBall\fP DNF5 will run entirely from system cache, will not update
133 the cache and will use the system cache even if it is expired.
134 .sp
135 If set to \fBmetadata\fP DNF5 will cache metadata only.
136 .sp
137 Default: \fBnone\fP\&.
138 .sp
139 \fBNOTE:\fP
140 .INDENT 7.0
141 .INDENT 3.5
142 API Notes: Must be set before repository objects are created. Plugins must set
143 this in the pre_config hook. Later changes are ignored.
144 .UNINDENT
145 .UNINDENT
146 .UNINDENT
147 .INDENT 0.0
148 .TP
149 .B \fBcheck_config_file_age\fP
150 \fI\%boolean\fP
151 .sp
152 If enabled DNF5 should automatically expire metadata of repos, which are older than
153 their corresponding configuration file (usually the dnf.conf file and the foo.repo file).
154 .sp
155 Default: \fBTrue\fP\&.
156 .sp
157 \fBNOTE:\fP
158 .INDENT 7.0
159 .INDENT 3.5
160 Expire of metadata is also affected by metadata age. See also
161 .sp
162 \fI\%metadata_expire\fP\&.
163 .UNINDENT
164 .UNINDENT
165 .UNINDENT
166 .INDENT 0.0
167 .TP
168 .B \fBclean_requirements_on_remove\fP
169 \fI\%boolean\fP
170 .sp
171 If enabled, DNF5 will remove dependencies that are no longer used during \fBdnf remove\fP\&.
172 A package only qualifies for removal via \fBclean_requirements_on_remove\fP if it was
173 installed through DNF5 but not on explicit user request, i.e. it was pulled in as a dependency.
174 .sp
175 \fI\%installonlypkgs\fP are never automatically removed.
176 .sp
177 Default: \fBTrue\fP\&.
178 .UNINDENT
179 .INDENT 0.0
180 .TP
181 .B \fBdebugdir\fP
182 \fI\%string\fP
183 .sp
184 Location where libsolv debug files will be created when enabled
185 by debug_solver\&.
186 .sp
187 Default \fI\&./debugdata\fP\&.
188 .UNINDENT
189 .INDENT 0.0
190 .TP
191 .B \fBdebug_solver\fP
192 \fI\%boolean\fP
193 .sp
194 If enabled, libsolv debug files will be created when solving the
195 transaction. The debug files are created in the debugdir directory.
196 .sp
197 Default: \fBFalse\fP\&.
198 .UNINDENT
199 .INDENT 0.0
200 .TP
201 .B \fBdefaultyes\fP
202 \fI\%boolean\fP
203 .sp
204 If enabled, the default answer to user confirmation prompts will be \fBYes\fP\&.
205 Not to be confused with \fI\%assumeyes\fP which will not prompt at all.
206 .sp
207 Default: \fBFalse\fP\&.
208 .UNINDENT
209 .INDENT 0.0
210 .TP
211 .B \fBdestdir\fP
212 \fI\%string\fP
213 .sp
214 Redirect downloaded packages to provided directory.
215 .sp
216 Default: <package repository \fI\%cachedir\fP>/packages
217 .UNINDENT
218 .INDENT 0.0
219 .TP
220 .B \fBexclude_from_weak\fP
221 \fI\%list\fP
222 .sp
223 Prevent installing packages as weak dependencies (recommends or
224 supplements). The packages can be specified by a name or a glob and
225 separated by a comma.
226 .sp
227 Defaults to [].
228 .UNINDENT
229 .INDENT 0.0
230 .TP
231 .B \fBexclude_from_weak_autodetect\fP
232 \fI\%boolean\fP
233 .sp
234 If enabled, DNF5 will autodetect unmet weak dependencies (recommends or
235 supplements) of packages installed on the system. Providers of these weak
236 dependencies will not be installed by dnf as weak dependencies any more
237 (they will still be installed if pulled in as a regular dependency).
238 .sp
239 Defaults to true.
240 .UNINDENT
241 .INDENT 0.0
242 .TP
243 .B \fBexcludeenvs\fP
244 \fI\%list\fP
245 .sp
246 Exclude environments, specified by an id or a glob and separated by a comma, from all operations.
247 .sp
248 Can be disabled using \fBdisable_excludes\fP config option.
249 .sp
250 Default: \fB[]\fP\&.
251 .UNINDENT
252 .INDENT 0.0
253 .TP
254 .B \fBexcludegroups\fP
255 \fI\%list\fP
256 .sp
257 Exclude groups, specified by an id or a glob and separated by a comma, from all operations.
258 .sp
259 Can be disabled using \fBdisable_excludes\fP config option.
260 .sp
261 Default: \fB[]\fP\&.
262 .UNINDENT
263 .INDENT 0.0
264 .TP
265 .B \fBgroup_package_types\fP
266 \fI\%list\fP
267 .sp
268 List of the following: \fBoptional\fP, \fBdefault\fP, \fBmandatory\fP or \fBconditional\fP\&.
269 .sp
270 Tells DNF5 which type of packages in groups will be installed when \(aqgroup install <group\-spec>\(aq
271 or \(aqinstall @<group\-spec>\(aq is called.
272 .sp
273 Default: \fBdefault, mandatory, conditional\fP\&.
274 .UNINDENT
275 .INDENT 0.0
276 .TP
277 .B \fBignorearch\fP
278 \fI\%boolean\fP
279 .sp
280 If enabled, RPM will allow attempts to install packages incompatible with the CPU\(aqs architecture.
281 .sp
282 Default: \fBFalse\fP\&.
283 .UNINDENT
284 .INDENT 0.0
285 .TP
286 .B \fBinstallonlypkgs\fP
287 \fI\%list\fP
288 .sp
289 List of provide names of packages that should only ever be installed, never
290 upgraded. Kernels in particular fall into this category.
291 These packages are never removed by \fBdnf autoremove\fP even if they were
292 installed as dependencies (see
293 \fI\%clean_requirements_on_remove\fP
294 for auto removal details).
295 This option append the list values to the default installonlypkgs list used
296 by DNF5. The number of kept package versions is regulated
297 by \fI\%installonly_limit\fP\&.
298 .UNINDENT
299 .INDENT 0.0
300 .TP
301 .B \fBinstallonly_limit\fP
302 \fI\%integer\fP
303 .sp
304 Number of \fI\%installonly packages\fP allowed to be installed
305 concurrently.
306 .sp
307 \fB1\fP is explicitly not allowed since it complicates kernel upgrades due to protection of
308 the running kernel from removal.
309 .sp
310 Minimum is \fB2\fP\&.
311 .sp
312 \fB0\fP means unlimited number of installonly packages.
313 .sp
314 Default: \fB3\fP\&.
315 .UNINDENT
316 .INDENT 0.0
317 .TP
318 .B \fBinstallroot\fP
319 \fI\%string\fP
320 .sp
321 The root of the filesystem for all packaging operations.
322 It requires an absolute path.
323 See also \fI\%\-\-installroot commandline option\fP\&.
324 .sp
325 Default: \fB/\fP\&.
326 .UNINDENT
327 .INDENT 0.0
328 .TP
329 .B \fBinstall_weak_deps\fP
330 \fI\%boolean\fP
331 .sp
332 If enabled, when a new package is about to be installed, all packages linked by weak dependency
333 relation (Recommends or Supplements flags) with this package will be pulled into the transaction.
334 .sp
335 Default: \fBTrue\fP\&.
336 .UNINDENT
337 .INDENT 0.0
338 .TP
339 .B \fBkeepcache\fP
340 \fI\%boolean\fP
341 .sp
342 If enabled, keeps downloaded packages in the cache. If disabled cache will persist
343 until the next successful transaction even if no packages have been installed.
344 .sp
345 Default: \fBFalse\fP\&.
346 .UNINDENT
347 .INDENT 0.0
348 .TP
349 .B \fBlogdir\fP
350 \fI\%string\fP
351 .sp
352 Directory where the log files will be stored.
353 .sp
354 Regular user default: \fB~/.local/state\fP\&.
355 .sp
356 Superuser default: \fB/var/log\fP\&.
357 .UNINDENT
358 .INDENT 0.0
359 .TP
360 .B \fBlog_rotate\fP
361 \fI\%integer\fP
362 .sp
363 Log files are rotated \fBlog_rotate\fP times before being removed.
364 If \fBlog_rotate\fP is \fB0\fP, the rotation is not performed.
365 .sp
366 Default: \fB4\fP\&.
367 .UNINDENT
368 .INDENT 0.0
369 .TP
370 .B \fBlog_size\fP
371 \fI\%storage size\fP
372 .sp
373 Log files are rotated when they grow bigger than \fBlog_size\fP bytes. If
374 \fBlog_size\fP is \fB0\fP, the rotation is not performed.
375 .sp
376 The size applies for individual log files, not the sum of all log files.
377 See also \fI\%log_rotate\fP\&.
378 .sp
379 Default: \fB1M\fP\&.
380 .UNINDENT
381 .INDENT 0.0
382 .TP
383 .B \fBmodule_platform_id\fP
384 \fI\%string\fP
385 .sp
386 Set this to \fB$name:$stream\fP to override \fBPLATFORM_ID\fP detected from \fB/etc/os\-release\fP\&.
387 It is necessary to perform a system upgrade and switch to a new platform.
388 .sp
389 Default: empty.
390 .UNINDENT
391 .INDENT 0.0
392 .TP
393 .B \fBmodule_stream_switch\fP
394 \fI\%boolean\fP
395 .sp
396 If enabled, allows switching enabled streams of a module.
397 .sp
398 Default: \fBFalse\fP\&.
399 .UNINDENT
400 .INDENT 0.0
401 .TP
402 .B \fBmultilib_policy\fP
403 \fI\%string\fP
404 .sp
405 Controls how multilib packages are treated during install operations.
406 .sp
407 Can either be \fBbest\fP for the depsolver to prefer packages which best match the system\(aqs
408 architecture, or \fBall\fP to install packages for all available architectures.
409 .sp
410 Default: \fBbest\fP\&.
411 .UNINDENT
412 .INDENT 0.0
413 .TP
414 .B \fBobsoletes\fP
415 \fI\%boolean\fP
416 .sp
417 If enabled, DNF5 uses obsoletes processing logic, which means it checks whether
418 any dependencies of given package are no longer required and removes them.
419 .sp
420 Useful when doing distribution level upgrades.
421 .sp
422 It has effect during install/upgrade processes.
423 .sp
424 Command\-line option: \fI\%\-\-obsoletes\fP
425 .sp
426 Default: \fBTrue\fP\&.
427 .UNINDENT
428 .INDENT 0.0
429 .TP
430 .B \fBoptional_metadata_types\fP
431 \fI\%list\fP
432 .sp
433 List of the following: \fBcomps\fP, \fBfilelists\fP, \fBother\fP, \fBpresto\fP, \fBupdateinfo\fP, \fBall\fP
434 .sp
435 Specifies the types of metadata to load in addition to the essential \fBprimary\fP and \fBmodules\fP metadata, which are always loaded. Note that individual DNF commands may extend this list at runtime.
436 .sp
437 Note: The list includes only metadata types recognized by DNF. However, a repository\(aqs metadata may include various other types (e.g., AppStream or metadata stored as databases instead of XML files). The special value \fBall\fP represents all metadata types present in the repository, including those unknown to DNF.
438 .sp
439 Default: \fBcomps,updateinfo\fP
440 .UNINDENT
441 .INDENT 0.0
442 .TP
443 .B \fBpersistdir\fP
444 \fI\%string\fP
445 .sp
446 Directory where DNF5 stores its persistent data between runs.
447 .sp
448 Default: \fB/var/lib/dnf\fP\&.
449 .UNINDENT
450 .INDENT 0.0
451 .TP
452 .B \fBpluginconfpath\fP
453 \fI\%list\fP
454 .sp
455 List of directories that are searched for libdnf5 plugin configurations to load.
456 .sp
457 All configuration files found in these directories, that are named same as a
458 plugin, are parsed.
459 .sp
460 Default: \fB/etc/dnf/libdnf5\-plugins\fP\&.
461 .UNINDENT
462 .INDENT 0.0
463 .TP
464 .B \fBpluginpath\fP
465 \fI\%list\fP
466 .sp
467 List of directories that are searched for libdnf5 plugins to load. Plugins found in
468 \fIany of the directories\fP in this configuration option are used.
469 .sp
470 Default: \fB/usr/lib64/libdnf5/plugins/\fP
471 .UNINDENT
472 .INDENT 0.0
473 .TP
474 .B \fBplugins\fP
475 \fI\%boolean\fP
476 .sp
477 If enabled, libdnf5 plugins are enabled.
478 .sp
479 Default: \fBTrue\fP\&.
480 .UNINDENT
481 .INDENT 0.0
482 .TP
483 .B \fBprotected_packages\fP
484 \fI\%list\fP
485 .sp
486 This append list option contains names of packages that DNF5 should never completely remove.
487 .sp
488 They are protected via Obsoletes as well as user/plugin removals.
489 .sp
490 Default: \fBdnf5,glob:/etc/dnf/protected.d/*.conf\fP\&.
491 .sp
492 \fBNOTE:\fP
493 .INDENT 7.0
494 .INDENT 3.5
495 Any packages which should be protected can do so by including a file in \fB/etc/dnf/protected.d\fP
496 with their package name in it.
497 .sp
498 DNF5 will protect also the package corresponding to the running version of the kernel. See also
499 \fI\%protect_running_kernel\fP option.
500 .UNINDENT
501 .UNINDENT
502 .UNINDENT
503 .INDENT 0.0
504 .TP
505 .B \fBprotect_running_kernel\fP
506 \fI\%boolean\fP
507 .sp
508 Controls whether the package corresponding to the running version of kernel is protected from removal.
509 .sp
510 Default: \fBTrue\fP\&.
511 .sp
512 \fBNOTE:\fP
513 .INDENT 7.0
514 .INDENT 3.5
515 YUM compatibility option
516 .UNINDENT
517 .UNINDENT
518 .UNINDENT
519 .INDENT 0.0
520 .TP
521 .B \fBrecent\fP
522 \fI\%integer\fP
523 .sp
524 Sets the time period in days used for the \fB\-\-recent\fP option in the \fI\%repoquery\fP,
525 \fI\%info\fP and \fI\%list\fP commands.
526 .sp
527 Default: 7
528 .UNINDENT
529 .INDENT 0.0
530 .TP
531 .B \fBreposdir\fP
532 \fI\%list\fP
533 .sp
534 Repository configuration files locations.
535 .sp
536 The behavior of \fBreposdir\fP could differ when it is used
537 along with \-\fI\%\-installroot\fP option.
538 .sp
539 Default: [\fB/etc/yum.repos.d\fP, \fB/etc/distro.repos.d\fP, \fB/usr/share/dnf5/repos.d\fP]
540 .UNINDENT
541 .INDENT 0.0
542 .TP
543 .B \fBskip_broken\fP
544 \fI\%boolean\fP
545 .sp
546 If enabled, DNF5 will skip uninstallable packages instead of failing while
547 resolving dependencies.
548 .sp
549 Default: \fBFalse\fP\&.
550 .UNINDENT
551 .INDENT 0.0
552 .TP
553 .B \fBskip_system_repo_lock\fP
554 \fI\%boolean\fP
555 .sp
556 Skip acquiring a lock on the system repository (equivalent to the RPM
557 database). The lock is used to prevent processes from reading the system
558 repository while another process is running a transaction. Unprivileged
559 users are allowed to acquire a read lock on the system repository, so
560 \fBskip_system_repo_lock=true\fP may be used to ignore their lock.
561 .UNINDENT
562 .INDENT 0.0
563 .TP
564 .B \fBskip_unavailable\fP
565 \fI\%boolean\fP
566 .sp
567 If enabled, DNF5 will skip unavailable packages instead of failing while
568 preparing rpm transactions.
569 .sp
570 Default: \fBFalse\fP\&.
571 .UNINDENT
572 .sp
573 \fBsystem_cachedir\fP
574 .INDENT 0.0
575 .INDENT 3.5
576 \fI\%string\fP
577 .sp
578 For superuser overwrites the \fI\%cachedir\fP option value.
579 .sp
580 Allows one to differentiate user and superuser cachedir.
581 .sp
582 Default: \fB/var/cache/libdnf5\fP\&.
583 .UNINDENT
584 .UNINDENT
585 .INDENT 0.0
586 .TP
587 .B \fBsystem_state_dir\fP
588 \fI\%string\fP
589 .sp
590 System state files location. See \fBdnf5\-system\-state(7)\fP, \fI\%system state\fP for details.
591 .sp
592 Default: \fB/usr/lib/sysimage/libdnf5\fP\&.
593 .UNINDENT
594 .sp
595 \fBtransaction_history_dir\fP
596 .INDENT 0.0
597 .INDENT 3.5
598 \fI\%string\fP
599 .sp
600 History database location.
601 .sp
602 By default it has the same value as system_state_dir\&.
603 .UNINDENT
604 .UNINDENT
605 .INDENT 0.0
606 .TP
607 .B \fBtsflags\fP
608 \fI\%list\fP
609 .sp
610 List of strings adding extra flags for the RPM transaction.
611 .TS
612 box center;
613 l|l.
614 T{
615 tsflag value
616 T} T{
617 RPM Transaction Flag
618 T}
619 _
620 T{
621 \fBnoscripts\fP
622 T} T{
623 \fBRPMTRANS_FLAG_NOSCRIPTS\fP
624 T}
625 _
626 T{
627 \fBtest\fP
628 T} T{
629 \fBRPMTRANS_FLAG_TEST\fP
630 T}
631 _
632 T{
633 \fBnotriggers\fP
634 T} T{
635 \fBRPMTRANS_FLAG_NOTRIGGERS\fP
636 T}
637 _
638 T{
639 \fBnodocs\fP
640 T} T{
641 \fBRPMTRANS_FLAG_NODOCS\fP
642 T}
643 _
644 T{
645 \fBjustdb\fP
646 T} T{
647 \fBRPMTRANS_FLAG_JUSTDB\fP
648 T}
649 _
650 T{
651 \fBnocontexts\fP
652 T} T{
653 \fBRPMTRANS_FLAG_NOCONTEXTS\fP
654 T}
655 _
656 T{
657 \fBnocaps\fP
658 T} T{
659 \fBRPMTRANS_FLAG_NOCAPS\fP
660 T}
661 _
662 T{
663 \fBnocrypto\fP
664 T} T{
665 \fBRPMTRANS_FLAG_NOFILEDIGEST\fP
666 T}
667 _
668 T{
669 \fBdeploops\fP
670 T} T{
671 \fBRPMTRANS_FLAG_DEPLOOPS\fP
672 T}
673 .TE
674 .sp
675 The \fBnocrypto\fP option will also set the \fB_RPMVSF_NOSIGNATURES\fP and
676 \fB_RPMVSF_NODIGESTS\fP VS flags.
677 .sp
678 The \fBtest\fP option provides a transaction check without performing the transaction.
679 It includes downloading of packages, OpenPGP keys check (including permanent import of
680 additional keys if necessary), and rpm check to prevent file conflicts.
681 .sp
682 The \fBnocaps\fP is supported with rpm\-4.14 or later. When \fBnocaps\fP is used but rpm
683 doesn\(aqt support it, DNF5 only reports it as an invalid tsflag.
684 .sp
685 Default: empty.
686 .UNINDENT
687 .sp
688 \fBuse_host_config\fP
689 .INDENT 0.0
690 .INDENT 3.5
691 Use configuration files and variable definitions from the host system rather
692 than the installroot.
693 \fI\%See\fP \fBdnf5\-installroot(7)\fP for more info.
694 .sp
695 Default: \fBFalse\fP\&.
696 .UNINDENT
697 .UNINDENT
698 .INDENT 0.0
699 .TP
700 .B \fBvarsdir\fP
701 \fI\%list\fP
702 .sp
703 List of directories where variables definition files are looked for.
704 .sp
705 See \fI\%variable files\fP in Configuration reference.
706 .sp
707 Default: \fB/etc/dnf/vars\fP\&.
708 .UNINDENT
709 .INDENT 0.0
710 .TP
711 .B \fBzchunk\fP
712 \fI\%boolean\fP
713 .sp
714 If enabled, repository metadata are compressed using the zchunk format (if available).
715 .sp
716 Default: \fBTrue\fP\&.
717 .UNINDENT
718 .SH [MAIN] OPTIONS - COLORS
719 .INDENT 0.0
720 .TP
721 .B \fBcolor_list_available_upgrade\fP
722 \fI\%color\fP
723 .sp
724 Color of available packages that are newer than installed packages.
725 The option is used during list operations.
726 .sp
727 Default: \fBbold,blue\fP\&.
728 .UNINDENT
729 .INDENT 0.0
730 .TP
731 .B \fBcolor_list_available_downgrade\fP
732 \fI\%color\fP
733 .sp
734 Color of available packages that are older than installed packages.
735 The option is used during list operations.
736 .sp
737 Default: \fBdim,magenta\fP\&.
738 .UNINDENT
739 .INDENT 0.0
740 .TP
741 .B \fBcolor_list_available_reinstall\fP
742 \fI\%color\fP
743 .sp
744 Color of available packages that are identical to installed versions and are available for reinstalls.
745 The option is used during list operations.
746 .sp
747 Default: \fBbold,green\fP\&.
748 .UNINDENT
749 .INDENT 0.0
750 .TP
751 .B \fBcolor_list_available_install\fP
752 \fI\%color\fP
753 .sp
754 Color of packages that are available for installation and none of their versions in installed.
755 The option is used during list operations.
756 .sp
757 Default: \fBbold,cyan\fP\&.
758 .UNINDENT
759 .INDENT 0.0
760 .TP
761 .B \fBcolor_update_installed\fP
762 \fI\%color\fP
763 .sp
764 Color of removed packages.
765 This option is used during displaying transactions.
766 .sp
767 Default: \fBdim,red\fP\&.
768 .UNINDENT
769 .INDENT 0.0
770 .TP
771 .B \fBcolor_update_local\fP
772 \fI\%color\fP
773 .sp
774 Color of local packages that are installed from the @commandline repository.
775 This option is used during displaying transactions.
776 .sp
777 Default: \fBdim,green\fP\&.
778 .UNINDENT
779 .INDENT 0.0
780 .TP
781 .B \fBcolor_update_remote\fP
782 \fI\%color\fP
783 .sp
784 Color of packages that are installed/upgraded/downgraded from remote repositories.
785 This option is used during displaying transactions.
786 .sp
787 Default: \fBbold,green\fP\&.
788 .UNINDENT
789 .INDENT 0.0
790 .TP
791 .B \fBcolor_search_match\fP
792 \fI\%color\fP
793 .sp
794 Color of patterns matched in search output.
795 .sp
796 Default: \fBbold,magenta\fP\&.
797 .UNINDENT
798 .SH REPO OPTIONS
799 .INDENT 0.0
800 .TP
801 .B \fBbaseurl\fP
802 \fI\%list\fP
803 .sp
804 List of URLs for the repository.
805 .sp
806 Default [].
807 .sp
808 URLs are tried in the listed order (equivalent to yum’s “failovermethod=priority” behaviour).
809 .UNINDENT
810 .INDENT 0.0
811 .TP
812 .B \fBcost\fP
813 \fI\%integer\fP
814 .sp
815 The relative cost of accessing this repository, defaulting to 1000. This
816 value is compared when the priorities of two repositories are the same. The
817 repository with the lowest cost is picked. It is useful to make the library
818 prefer on\-disk repositories to remote ones.
819 .UNINDENT
820 .INDENT 0.0
821 .TP
822 .B \fBenabled\fP
823 \fI\%boolean\fP
824 .sp
825 Include this repository as a package source.
826 .sp
827 Default: \fBTrue\fP\&.
828 .UNINDENT
829 .INDENT 0.0
830 .TP
831 .B \fBgpgkey\fP
832 \fI\%list\fP
833 .sp
834 URLs of a OpenPGP key files that can be used for signing metadata and packages
835 of this repository. If a file can not be verified using
836 the already imported keys, import of keys from this option is attempted and
837 the keys are then used for verification.
838 .sp
839 Default: \fB[]\fP
840 .UNINDENT
841 .INDENT 0.0
842 .TP
843 .B \fBmetalink\fP
844 \fI\%string\fP
845 .sp
846 URL of a metalink for the repository.
847 .sp
848 Default: \fBNone\fP\&.
849 .UNINDENT
850 .INDENT 0.0
851 .TP
852 .B \fBmirrorlist\fP
853 \fI\%string\fP
854 .sp
855 URL of a mirrorlist for the repository.
856 .sp
857 Default: \fBNone\fP\&.
858 .UNINDENT
859 .INDENT 0.0
860 .TP
861 .B \fBname\fP
862 \fI\%string\fP
863 .sp
864 A human\-readable name of the repository. Defaults to the ID of the repository.
865 .UNINDENT
866 .INDENT 0.0
867 .TP
868 .B \fBpriority\fP
869 \fI\%integer\fP
870 .sp
871 The priority value of this repository. If there is more than
872 one candidate package for a particular operation, the one from a repo with
873 the lowest priority value is picked, possibly despite being less convenient
874 otherwise (e.g. by being a lower version).
875 .sp
876 Default: 99
877 .UNINDENT
878 .INDENT 0.0
879 .TP
880 .B \fBtype\fP
881 \fI\%string\fP
882 .sp
883 Type of repository metadata. Supported values are: \fBrpm\-md\fP\&. Aliases for
884 \fBrpm\-md\fP: \fBrpm\fP, \fBrepomd\fP, \fBrpmmd\fP, \fByum\fP, \fBYUM\fP\&.
885 .sp
886 Default: empty.
887 .UNINDENT
888 .SH SOURCE AND DEBUGINFO REPOSITORY NAMES
889 .sp
890 For a given repository with an identifier in the form \(dq<ID>\-rpms\(dq, its corresponding source repository is expected to have an identifier in the form \(dq<ID>\-source\-rpms\(dq and debuginfo repository an identifier in the form \(dq<ID>\-debug\-rpms\(dq. Otherwise (if the repository identifier doesn\(aqt have the \(dq\-rpms\(dq suffix), the source repository is expected to have an identifier in the form \(dq<ID>\-source\(dq and debuginfo repository an identifier in the form \(dq<ID>\-debuginfo\(dq.
891 .sp
892 For example, for repository \(dqfedora\(dq, the source repository is \(dqfedora\-source\(dq and debuginfo repository is \(dqfedora\-debuginfo\(dq. For repository \(dqfedora\-rpms\(dq, the source repository is \(dqfedora\-source\-rpms\(dq and debuginfo repository is \(dqfedora\-debug\-rpms\(dq.
893 .SH REPO VARIABLES
894 .sp
895 Right side of every repo option can be enriched by the following variables:
896 .sp
897 \fB$arch\fP
898 .INDENT 0.0
899 .INDENT 3.5
900 Refers to the system’s CPU architecture e.g, aarch64, i586, i686 and x86_64.
901 .UNINDENT
902 .UNINDENT
903 .sp
904 \fB$basearch\fP
905 .INDENT 0.0
906 .INDENT 3.5
907 Refers to the base architecture of the system. For example, i686 and i586 machines
908 both have a base architecture of i386, and AMD64 and Intel64 machines have a base architecture of x86_64.
909 .UNINDENT
910 .UNINDENT
911 .sp
912 \fB$releasever\fP
913 .INDENT 0.0
914 .INDENT 3.5
915 Refers to the release version of operating system which DNF5 derives from information available in RPMDB.
916 .UNINDENT
917 .UNINDENT
918 .sp
919 In addition to these hard coded variables, user\-defined ones can also be used.
920 They can be defined either via \fI\%variable files\fP, or by using special environmental variables.
921 The names of these variables must be prefixed with DNF_VAR_ and they can only consist of alphanumeric characters
922 and underscores:
923 .INDENT 0.0
924 .INDENT 3.5
925 .sp
926 .EX
927 $ DNF_VAR_MY_VARIABLE=value
928 .EE
929 .UNINDENT
930 .UNINDENT
931 .sp
932 To use such variable in your repository configuration remove the prefix. E.g.:
933 .INDENT 0.0
934 .INDENT 3.5
935 .sp
936 .EX
937 [myrepo]
938 baseurl=https://example.site/pub/fedora/$MY_VARIABLE/releases/$releasever
939 .EE
940 .UNINDENT
941 .UNINDENT
942 .sp
943 Note that it is not possible to override the \fBarch\fP and \fBbasearch\fP variables using either variable files or
944 environmental variables.
945 .sp
946 Although users are encouraged to use named variables, the numbered environmental variables
947 \fBDNF0\fP \- \fBDNF9\fP are still supported:
948 .INDENT 0.0
949 .INDENT 3.5
950 .sp
951 .EX
952 $ DNF1=value
953
954 [myrepo]
955 baseurl=https://example.site/pub/fedora/$DNF1/releases/$releasever
956 .EE
957 .UNINDENT
958 .UNINDENT
959 .SH OPTIONS FOR BOTH [MAIN] AND REPO
960 .sp
961 Some options can be applied in either the main section, per repository, or in a
962 combination. The value provided in the main section is used for all repositories
963 as the default value, which repositories can then override in their
964 configuration.
965 .INDENT 0.0
966 .TP
967 .B \fBbandwidth\fP
968 \fI\%storage size\fP
969 .sp
970 Total bandwidth available for downloading.
971 Meaningful when used with the \fI\%throttle option\fP\&.
972 .sp
973 Default: \fB0\fP\&.
974 .UNINDENT
975 .INDENT 0.0
976 .TP
977 .B \fBbuild_cache\fP
978 \fI\%boolean\fP
979 .sp
980 If enabled, DNF5 will save libsolv cache generated from downloaded metadata
981 to cachedir. These solv files are loaded during subsequent runs which
982 significantly speeds up DNF5.
983 .sp
984 Default: \fBTrue\fP\&.
985 .UNINDENT
986 .INDENT 0.0
987 .TP
988 .B \fBcountme\fP
989 \fI\%boolean\fP
990 .sp
991 When enabled, one (and only one) HTTP GET request for the metalink file
992 will be selected at random every week to carry a special URL flag.
993 .sp
994 This flag allows the repository provider to estimate the number of systems
995 consuming the repository, by counting such requests over a week\(aqs time.
996 This method is more accurate than just counting unique IP addresses (which
997 is subject to both overcounting and undercounting due to short DHCP leases
998 and NAT, respectively).
999 .sp
1000 This is \fInot\fP an out\-of\-band HTTP request made for this purpose alone.
1001 Only requests initiated by DNF during normal operation, such as to check
1002 for metadata updates, can get this flag.
1003 .sp
1004 The flag is a simple \(dqcountme=N\(dq parameter appended to the metalink URL
1005 where N is an integer representing the age \(dqbucket\(dq this system belongs to.
1006 Four buckets are defined, based on how many full weeks have passed since
1007 the installation of a system:
1008 .TS
1009 box center;
1010 l|l.
1011 T{
1012 bucket
1013 T} T{
1014 system age
1015 T}
1016 _
1017 T{
1018 1
1019 T} T{
1020 first week
1021 T}
1022 _
1023 T{
1024 2
1025 T} T{
1026 first month (2 \- 4 weeks)
1027 T}
1028 _
1029 T{
1030 3
1031 T} T{
1032 first 6 months (5 \- 24 weeks)
1033 T}
1034 _
1035 T{
1036 4
1037 T} T{
1038 more than 6 months (> 24 weeks)
1039 T}
1040 .TE
1041 .sp
1042 This number is meant to help distinguish short\-lived (throwaway) machines
1043 from long\-term installs and get a better picture of how systems are used
1044 over time.
1045 .sp
1046 To determine a system\(aqs installation time (\(dqepoch\(dq), the \fBmachine\-id(5)\fP
1047 file\(aqs modification time is used as the single source of truth. This file
1048 is semantically tied to the system\(aqs lifetime as it\(aqs typically populated
1049 at installation time or during the first boot by an installer tool or init
1050 system (such as \fBsystemd(1)\fP), respectively, and remains unchanged.
1051 .sp
1052 If the file is empty or missing (such as in containers), the time of the
1053 very first request made using the expanded metalink URL (i.e. with any
1054 repository variables such as \fB$releasever\fP substituted) that carried the
1055 flag is declared as the epoch.
1056 .sp
1057 If no metalink URL is defined for this repository but a mirrorlist URL is,
1058 the latter is used for this purpose instead.
1059 .sp
1060 Default: \fBFalse\fP\&.
1061 .UNINDENT
1062 .INDENT 0.0
1063 .TP
1064 .B \fBdisable_excludes\fP
1065 \fI\%list\fP
1066 .sp
1067 Used to disable package, group and environment filtering. It can include a list of repository IDs (globs allowed) for which repository\-specific package excludes are ignored. If it contains the special value \fBmain\fP, excludes from the main configuration files are bypassed. If it contains the special value \fB*\fP, no excludes filtering is applied at all.
1068 .UNINDENT
1069 .INDENT 0.0
1070 .TP
1071 .B \fBenablegroups\fP
1072 \fI\%boolean\fP
1073 .sp
1074 If enabled, DNF5 will allow the use of package groups.
1075 .sp
1076 Default: \fBTrue\fP\&.
1077 .UNINDENT
1078 .INDENT 0.0
1079 .TP
1080 .B \fBexcludepkgs\fP
1081 \fI\%list\fP
1082 .sp
1083 Exclude packages of this repository, specified by a name or a glob and
1084 separated by a comma, from all operations.
1085 .sp
1086 Can be disabled using \fBdisable_excludes\fP config option.
1087 .sp
1088 Default: \fB[]\fP\&.
1089 .UNINDENT
1090 .INDENT 0.0
1091 .TP
1092 .B \fBfastestmirror\fP
1093 \fI\%boolean\fP
1094 .sp
1095 If enabled, TCP socket latency is used to find the closest available mirror.
1096 A mirror is then selected at random with less than twice the lowest latency for load balancing purposes.
1097 This overrides the order provided by the mirrorlist/metalink file itself,
1098 and does not take into consideration mirrorlist parameters such as mirror bandwidth nor preferred mirrors for client IP addresses.
1099 .sp
1100 Default: \fBFalse\fP\&.
1101 .UNINDENT
1102 .INDENT 0.0
1103 .TP
1104 .B \fBpkg_gpgcheck\fP
1105 \fI\%boolean\fP
1106 .sp
1107 Whether to perform OpenPGP signature check on packages found in this repository.
1108 .sp
1109 The default is False.
1110 .sp
1111 Doesn\(aqt apply for packages passed directly as arguments, as they are not in any repository,
1112 see \fI\%localpkg_gpgcheck\fP\&.
1113 .sp
1114 Due to compatibility \fIgpgcheck\fP option is supported as well but \fIpkg_gpgcheck\fP is preferred.
1115 .UNINDENT
1116 .INDENT 0.0
1117 .TP
1118 .B \fBincludepkgs\fP
1119 \fI\%list\fP
1120 .sp
1121 Include packages of this repository, specified by a name or a glob and separated by a comma, in all operations.
1122 .sp
1123 Inverse of \fI\%excludepkgs\fP, DNF5 will exclude any package in the repository
1124 that doesn\(aqt match this list.
1125 .sp
1126 This works in conjunction with \fI\%excludepkgs\fP and doesn\(aqt override it,
1127 so if you \(aqexcludepkgs=*.i386\(aq and \(aqincludepkgs=python*\(aq then only packages starting with python
1128 that do not have an i386 arch will be seen by DNF5 in this repo.
1129 .sp
1130 Can be disabled using \fBdisable_excludes\fP config option.
1131 .sp
1132 Default: \fB[]\fP\&.
1133 .UNINDENT
1134 .INDENT 0.0
1135 .TP
1136 .B \fBip_resolve\fP
1137 \fI\%ip address\fP
1138 .sp
1139 Determines how DNF5 resolves host names. Set this to \fB4\fP, \fBIPv4\fP, \fB6\fP, \fBIPv6\fP
1140 to resolve to IPv4 or IPv6 addresses only.
1141 .sp
1142 Default: \fBwhatever\fP\&.
1143 .UNINDENT
1144 .INDENT 0.0
1145 .TP
1146 .B \fBlocalpkg_gpgcheck\fP
1147 \fI\%boolean\fP
1148 .sp
1149 If enabled, DNF5 will perform a OpenPGP signature check on local packages (packages in a file, not in a repository).
1150 .sp
1151 Default: \fBFalse\fP\&.
1152 .UNINDENT
1153 .INDENT 0.0
1154 .TP
1155 .B \fBmax_parallel_downloads\fP
1156 \fI\%integer\fP
1157 .sp
1158 Maximum number of simultaneous downloads. Max is \fB20\fP\&.
1159 .sp
1160 Default: \fB3\fP\&.
1161 .UNINDENT
1162 .INDENT 0.0
1163 .TP
1164 .B \fBmax_downloads_per_mirror\fP
1165 \fI\%integer\fP
1166 .sp
1167 Maximum number of simultaneous downloads per mirror. Max is \fB20\fP\&.
1168 .sp
1169 Default: \fB3\fP\&.
1170 .UNINDENT
1171 .INDENT 0.0
1172 .TP
1173 .B \fBmetadata_expire\fP
1174 \fI\%time in seconds\fP
1175 .sp
1176 The period after which the remote repository is checked for metadata update and in the positive
1177 case the local metadata cache is updated.
1178 It can be \fB\-1\fP or \fBnever\fP to make the repo never considered expired.
1179 .sp
1180 Expire of metadata can be also triggered by change of timestamp of configuration files
1181 (\fBdnf.conf\fP, \fB<repo>.repo\fP).
1182 .sp
1183 See also \fI\%check_config_file_age\fP\&.
1184 .sp
1185 Default: \fB60 * 60 * 48\fP, 48 hours.
1186 .UNINDENT
1187 .INDENT 0.0
1188 .TP
1189 .B \fBminrate\fP
1190 \fI\%storage size\fP
1191 .sp
1192 Sets the low speed threshold in bytes per second.
1193 If the server is sending data at the same or slower speed than this value for at least
1194 \fI\%timeout option\fP seconds, DNF5 aborts the connection.
1195 .sp
1196 Default: \fB1000\fP\&.
1197 .UNINDENT
1198 .INDENT 0.0
1199 .TP
1200 .B \fBpassword\fP
1201 \fI\%string\fP
1202 .sp
1203 The password used to connect to a repository with basic HTTP authentication.
1204 .sp
1205 Default: empty.
1206 .UNINDENT
1207 .INDENT 0.0
1208 .TP
1209 .B \fBproxy\fP
1210 \fI\%string\fP
1211 .sp
1212 URL of a proxy server to connect through.
1213 .sp
1214 Set to an empty string in the repository configuration to disable proxy
1215 setting inherited from the main section. The expected format of this option is
1216 \fB<scheme>://<ip\-or\-hostname>[:port]\fP\&.
1217 (For backward compatibility, \(aq_none_\(aq can be used instead of the empty string.)
1218 .sp
1219 Default: empty.
1220 .sp
1221 \fBNOTE:\fP
1222 .INDENT 7.0
1223 .INDENT 3.5
1224 The curl environment variables (such as \fBhttp_proxy\fP) are effective if this option is unset
1225 (or \(aq_none_\(aq is set in the repository configuration). See the \fBcurl\fP man page for details.
1226 .UNINDENT
1227 .UNINDENT
1228 .UNINDENT
1229 .INDENT 0.0
1230 .TP
1231 .B \fBproxy_username\fP
1232 \fI\%string\fP
1233 .sp
1234 The username to use for connecting to the proxy server.
1235 .sp
1236 Default: empty.
1237 .UNINDENT
1238 .INDENT 0.0
1239 .TP
1240 .B \fBproxy_password\fP
1241 \fI\%string\fP
1242 .sp
1243 The password to use for connecting to the proxy server.
1244 .sp
1245 Default: empty.
1246 .UNINDENT
1247 .INDENT 0.0
1248 .TP
1249 .B \fBproxy_auth_method\fP
1250 \fI\%string\fP
1251 .sp
1252 The authentication method used by the proxy server. Valid values are
1253 .TS
1254 box center;
1255 l|l.
1256 T{
1257 method
1258 T} T{
1259 meaning
1260 T}
1261 _
1262 T{
1263 \fBbasic\fP
1264 T} T{
1265 HTTP Basic authentication
1266 T}
1267 _
1268 T{
1269 \fBdigest\fP
1270 T} T{
1271 HTTP Digest authentication
1272 T}
1273 _
1274 T{
1275 \fBnegotiate\fP
1276 T} T{
1277 HTTP Negotiate (SPNEGO) authentication
1278 T}
1279 _
1280 T{
1281 \fBntlm\fP
1282 T} T{
1283 HTTP NTLM authentication
1284 T}
1285 _
1286 T{
1287 \fBdigest_ie\fP
1288 T} T{
1289 HTTP Digest authentication with an IE flavor
1290 T}
1291 _
1292 T{
1293 \fBntlm_wb\fP
1294 T} T{
1295 NTLM delegating to winbind helper
1296 T}
1297 _
1298 T{
1299 \fBnone\fP
1300 T} T{
1301 None auth method
1302 T}
1303 _
1304 T{
1305 \fBany\fP
1306 T} T{
1307 All suitable methods
1308 T}
1309 .TE
1310 .sp
1311 Default: \fBany\fP\&.
1312 .UNINDENT
1313 .INDENT 0.0
1314 .TP
1315 .B \fBproxy_sslcacert\fP
1316 \fI\%string\fP
1317 .sp
1318 Path to the file containing the certificate authorities to verify proxy SSL certificates.
1319 .sp
1320 Default: empty, uses system default.
1321 .UNINDENT
1322 .INDENT 0.0
1323 .TP
1324 .B \fBproxy_sslclientcert\fP
1325 \fI\%string\fP
1326 .sp
1327 Path to the SSL client certificate used to connect to proxy server.
1328 .sp
1329 Default: empty.
1330 .UNINDENT
1331 .INDENT 0.0
1332 .TP
1333 .B \fBproxy_sslclientkey\fP
1334 \fI\%string\fP
1335 .sp
1336 Path to the SSL client key used to connect to proxy server.
1337 .sp
1338 Default: empty.
1339 .UNINDENT
1340 .INDENT 0.0
1341 .TP
1342 .B \fBproxy_sslverify\fP
1343 \fI\%boolean\fP
1344 .sp
1345 If enabled, proxy SSL certificates are verified. If the client can not be authenticated, connecting fails and the
1346 repository is not used any further. If \fBFalse\fP, SSL connections can be used, but certificates are not verified.
1347 .sp
1348 Default: \fBTrue\fP\&.
1349 .UNINDENT
1350 .INDENT 0.0
1351 .TP
1352 .B \fBrepo_gpgcheck\fP
1353 \fI\%boolean\fP
1354 .sp
1355 If enabled, DNF5 will perform OpenPGP signature check on this repository\(aqs metadata.
1356 .sp
1357 \fBNOTE:\fP
1358 .INDENT 7.0
1359 .INDENT 3.5
1360 OpenPGP keys for this check are stored separately from OpenPGP keys used in package signature
1361 verification. Furthermore, they are also stored separately for each repository.
1362 .sp
1363 This means that DNF5 may ask to import the same key multiple times. For example, when a key was
1364 already imported for package signature verification and this option is turned on, it may be needed
1365 to import it again for the repository.
1366 .UNINDENT
1367 .UNINDENT
1368 .sp
1369 Default: \fBFalse\fP\&.
1370 .UNINDENT
1371 .INDENT 0.0
1372 .TP
1373 .B \fBskip_if_unavailable\fP
1374 \fI\%boolean\fP
1375 .sp
1376 If enabled, DNF5 will continue running and disable the repository that couldn\(aqt be synchronized
1377 for any reason. This option doesn\(aqt affect skipping of unavailable packages after dependency
1378 resolution. To check inaccessibility of repository use it in combination with
1379 refresh command line option\&.
1380 .sp
1381 Default: \fBFalse\fP\&.
1382 .sp
1383 \fBNOTE:\fP
1384 .INDENT 7.0
1385 .INDENT 3.5
1386 this option in particular can be set in your configuration file
1387 by your distribution\&.
1388 .UNINDENT
1389 .UNINDENT
1390 .UNINDENT
1391 .INDENT 0.0
1392 .TP
1393 .B \fBsslcacert\fP
1394 \fI\%string\fP
1395 .sp
1396 Path to the file containing the certificate authorities to verify SSL certificates.
1397 .sp
1398 Default: empty, uses system default.
1399 .UNINDENT
1400 .INDENT 0.0
1401 .TP
1402 .B \fBsslclientcert\fP
1403 \fI\%string\fP
1404 .sp
1405 Path to the SSL client certificate used to connect to remote sites.
1406 .sp
1407 Default: empty.
1408 .UNINDENT
1409 .INDENT 0.0
1410 .TP
1411 .B \fBsslclientkey\fP
1412 \fI\%string\fP
1413 .sp
1414 Path to the SSL client key used to connect to remote sites.
1415 .sp
1416 Default: empty.
1417 .UNINDENT
1418 .INDENT 0.0
1419 .TP
1420 .B \fBsslverify\fP
1421 \fI\%boolean\fP
1422 .sp
1423 If enabled, remote SSL certificates are verified. If the client can not be authenticated,
1424 connecting fails and the repository is not used any further.
1425 If disabled, SSL connections can be used, but certificates are not verified.
1426 .sp
1427 Default: \fBTrue\fP\&.
1428 .UNINDENT
1429 .INDENT 0.0
1430 .TP
1431 .B \fBthrottle\fP
1432 \fI\%storage size\fP
1433 .sp
1434 Limits the downloading speed. It might be an absolute value or a percentage, relative to the value of the
1435 \fI\%bandwidth option\fP option. \fB0\fP means no throttling.
1436 .sp
1437 Default: \fB0\fP\&.
1438 .UNINDENT
1439 .INDENT 0.0
1440 .TP
1441 .B \fBtimeout\fP
1442 \fI\%time in seconds\fP
1443 .sp
1444 Number of seconds to wait for a connection before timing out. Used in combination with
1445 \fI\%minrate option\fP option.
1446 .sp
1447 Default: \fB30\fP\&.
1448 .UNINDENT
1449 .INDENT 0.0
1450 .TP
1451 .B \fBusername\fP
1452 \fI\%string\fP
1453 .sp
1454 The username to use for connecting to repo with basic HTTP authentication.
1455 .sp
1456 Default: empty.
1457 .UNINDENT
1458 .INDENT 0.0
1459 .TP
1460 .B \fBuser_agent\fP
1461 \fI\%string\fP
1462 .sp
1463 The User\-Agent string to include in HTTP requests sent by DNF5.
1464 .sp
1465 Default:
1466 .INDENT 7.0
1467 .INDENT 3.5
1468 .sp
1469 .EX
1470 libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)
1471 .EE
1472 .UNINDENT
1473 .UNINDENT
1474 .sp
1475 \fBNOTE:\fP
1476 .INDENT 7.0
1477 .INDENT 3.5
1478 \fBNAME\fP, \fBVERSION_ID\fP and \fBVARIANT_ID\fP are OS identifiers read from the
1479 \fBos\-release(5)\fP file, and \fBOS\fP and \fBBASEARCH\fP are the canonical OS
1480 name and base architecture, respectively.
1481 Example:
1482 .INDENT 0.0
1483 .INDENT 3.5
1484 .sp
1485 .EX
1486 libdnf (Fedora 39; server; Linux.x86_64)
1487 .EE
1488 .UNINDENT
1489 .UNINDENT
1490 .UNINDENT
1491 .UNINDENT
1492 .UNINDENT
1493 .SH TYPES OF OPTIONS
1494 .INDENT 0.0
1495 .TP
1496 .B \fBboolean\fP
1497 Data type with only two possible values.
1498 .sp
1499 One of following options can be used: \fB1\fP, \fB0\fP, \fBTrue\fP, \fBFalse\fP, \fByes\fP, \fBno\fP\&.
1500 .UNINDENT
1501 .INDENT 0.0
1502 .TP
1503 .B \fBcolor\fP
1504 String describing color and modifiers separated with a comma, for example \fBred,bold\fP\&.
1505 .INDENT 7.0
1506 .IP \(bu 2
1507 Colors: \fBblack\fP, \fBblue\fP, \fBcyan\fP, \fBgreen\fP, \fBmagenta\fP, \fBred\fP, \fBwhite\fP, \fByellow\fP\&.
1508 .IP \(bu 2
1509 Modifiers: \fBbold\fP, \fBblink\fP, \fBdim\fP, \fBnormal\fP, \fBreverse\fP, \fBunderline\fP\&.
1510 .UNINDENT
1511 .UNINDENT
1512 .INDENT 0.0
1513 .TP
1514 .B \fBinteger\fP
1515 Whole number that can be written without a fractional component.
1516 .UNINDENT
1517 .INDENT 0.0
1518 .TP
1519 .B \fBip address type\fP
1520 String describing ip address types.
1521 .sp
1522 One of the following options can be used: \fB4\fP, \fBIPv4\fP, \fB6\fP, \fBIPv6\fP\&.
1523 .UNINDENT
1524 .INDENT 0.0
1525 .TP
1526 .B \fBlist\fP
1527 String representing one or more strings separated by space or comma characters.
1528 The backslash \fB\(aq\e\(aq\fP can be used to escape any character, allowing it to be included literally in the individual strings.
1529 .sp
1530 Example: \fB\(aqitem1,item2\e,with\e,commas,item3\e with\e spaces item4\(aq\fP
1531 .UNINDENT
1532 .INDENT 0.0
1533 .TP
1534 .B \fBstorage size\fP
1535 String representing storage sizes formed by an integer and a unit.
1536 .sp
1537 Valid units are \fBk\fP, \fBM\fP, \fBG\fP\&.
1538 .UNINDENT
1539 .INDENT 0.0
1540 .TP
1541 .B \fBstring\fP
1542 It is a sequence of symbols or digits without any whitespace character.
1543 .UNINDENT
1544 .INDENT 0.0
1545 .TP
1546 .B \fBtime in seconds\fP
1547 String representing time units in seconds. Can be set to \fB\-1\fP or \fBnever\fP\&.
1548 .UNINDENT
1549 .SH DROP-IN CONFIGURATION DIRECTORIES
1550 .sp
1551 \fIDNF5\fP loads configuration options that are defined in the \fI\%main
1552 configuration file\fP, \fI\%user configuration
1553 files\fP and \fI\%distribution configuration
1554 files\fP\&.
1555 .sp
1556 The configuration files are processed following this order:
1557 .INDENT 0.0
1558 .IP 1. 3
1559 Configuration files are alphabetically sorted in a list of names from the
1560 distribution configuration directory\&. If
1561 a file with the same name is present in both directories, only the file from
1562 the user configuration directory is added to the list. The
1563 distribution file is then masked by the user file.
1564 .IP 2. 3
1565 Options are retrieved in order from the list The configuration from the next
1566 file overrides the previous one. The last option wins.
1567 .UNINDENT
1568 .SS Example of configuration files
1569 .sp
1570 User configuration files:
1571 .INDENT 0.0
1572 .IP \(bu 2
1573 /etc/dnf/dnf.conf
1574 .IP \(bu 2
1575 /etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
1576 .IP \(bu 2
1577 /etc/dnf/libdnf5.conf.d/60\-something.conf
1578 .IP \(bu 2
1579 /etc/dnf/libdnf5.conf.d/80\-user\-settings.conf
1580 .UNINDENT
1581 .sp
1582 Distribution configuration files:
1583 .INDENT 0.0
1584 .IP \(bu 2
1585 /usr/share/dnf5/libdnf.conf.d/50\-something.conf
1586 .IP \(bu 2
1587 /usr/share/dnf5/libdnf.conf.d/60\-something.conf
1588 .IP \(bu 2
1589 /usr/share/dnf5/libdnf.conf.d/90\-something.conf
1590 .UNINDENT
1591 .sp
1592 Resulting file loading order by default
1593 (/usr/share/dnf5/libdnf.conf.d/60\-something.conf is skipped, masked by
1594 the user file /etc/dnf/libdnf5.conf.d/60\-something.conf):
1595 .INDENT 0.0
1596 .IP 1. 3
1597 /etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
1598 .IP 2. 3
1599 /usr/share/dnf5/libdnf.conf.d/50\-something.conf
1600 .IP 3. 3
1601 /etc/dnf/libdnf5.conf.d/60\-something.conf
1602 .IP 4. 3
1603 /etc/dnf/libdnf5.conf.d/80\-user\-settings.conf
1604 .IP 5. 3
1605 /usr/share/dnf5/libdnf.conf.d/90\-something.conf
1606 .IP 6. 3
1607 /etc/dnf/dnf.conf
1608 .UNINDENT
1609 .SS Files and directories
1610 .INDENT 0.0
1611 .TP
1612 .B \fBUser Configuration Directory\fP
1613 /etc/dnf/libdnf5.conf.d/
1614 .UNINDENT
1615 .INDENT 0.0
1616 .TP
1617 .B \fBUser Configuration Files\fP
1618 /etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
1619 .UNINDENT
1620 .INDENT 0.0
1621 .TP
1622 .B \fBDistribution Configuration Directory\fP
1623 /usr/share/dnf5/libdnf.conf.d/
1624 .UNINDENT
1625 .INDENT 0.0
1626 .TP
1627 .B \fBDistribution Configuration Files\fP
1628 /usr/share/dnf5/libdnf.conf.d/50\-something.conf
1629 .UNINDENT
1630 .SH DROP-IN REPO DIRECTORIES
1631 .sp
1632 After the repository configurations are loaded other repo configurations can be overloaded from the directories
1633 \fI\%user repos override directory\fP
1634 and \fI\%distribution repos override directory\fP\&.
1635 .sp
1636 The format of the files inside the directories is the same as the format of the repository configuration files.
1637 The options in the overridden files can modify existing repos but cannot create new repositories.
1638 .sp
1639 Override files support globs in the repository ID in order to support bulk modifications of repository parameters.
1640 .sp
1641 The repository overrides are processed following this order:
1642 .INDENT 0.0
1643 .IP 1. 3
1644 Files from \fB/usr/share/dnf5/repos.override.d/\fP and \fB/etc/dnf5/repos.override.d/\fP are loaded in an alphabetically
1645 sorted list. In case files have the same name, the file from \fB/etc/dnf5/repos.override.d/\fP is used.
1646 This implies the list has only unique filenames. This also implies that the repository configuration files can be
1647 simply masked by creating a file with the same name in the \fB/etc\fP override directory.
1648 .IP 2. 3
1649 The options from the files are applied in the order they are loaded. The last option wins.
1650 .UNINDENT
1651 .sp
1652 \fBNOTE:\fP
1653 .INDENT 0.0
1654 .INDENT 3.5
1655 See also the documentation for \fI\%Config\-manager Command\fP to see where the overrides are used.
1656 .UNINDENT
1657 .UNINDENT
1658 .SS Example configuration
1659 .INDENT 0.0
1660 .INDENT 3.5
1661 .sp
1662 .EX
1663 # Enable \(gaskip_if_unavailable\(ga for all repositories
1664 [*]
1665 skip_if_unavailable = true
1666
1667 # And then disable \(gaskip_if_unavailable\(ga for repositories with id prefix \(dqfedora\(dq
1668 [fedora*]
1669 skip_if_unavailable = false
1670 .EE
1671 .UNINDENT
1672 .UNINDENT
1673 .SS Example of configuration files
1674 .sp
1675 This example shows the order in which override files are processed.
1676 .sp
1677 Files with user repos overrides:
1678 .INDENT 0.0
1679 .IP \(bu 2
1680 /etc/dnf/repos.override.d/20\-user\-overrides.repo
1681 .IP \(bu 2
1682 /etc/dnf/repos.override.d/60\-something2.repo
1683 .IP \(bu 2
1684 /etc/dnf/repos.override.d/80\-user\-overrides.repo
1685 .IP \(bu 2
1686 /etc/dnf/repos.override.d/99\-config\-manager.repo
1687 .UNINDENT
1688 .sp
1689 Files with distribution repos overrides:
1690 .INDENT 0.0
1691 .IP \(bu 2
1692 /usr/share/dnf5/repos.override.d/50\-something2.repo
1693 .IP \(bu 2
1694 /usr/share/dnf5/repos.override.d/60\-something2.repo
1695 .IP \(bu 2
1696 /usr/share/dnf5/repos.override.d/90\-something2.repo
1697 .UNINDENT
1698 .sp
1699 Resulting file processing order:
1700 .INDENT 0.0
1701 .IP 1. 3
1702 /etc/dnf/repos.override.d/20\-user\-overrides.repo
1703 .IP 2. 3
1704 /usr/share/dnf5/repos.override.d/50\-something2.repo
1705 .IP 3. 3
1706 /etc/dnf/repos.override.d/60\-something2.repo
1707 .IP 4. 3
1708 /etc/dnf/repos.override.d/80\-user\-overrides.repo
1709 .IP 5. 3
1710 /usr/share/dnf5/repos.override.d/90\-something2.repo
1711 .IP 6. 3
1712 /etc/dnf/repos.override.d/99\-config\-manager.repo
1713 .UNINDENT
1714 .SS Files and directories
1715 .INDENT 0.0
1716 .TP
1717 .B \fBUser Repos Override Directory\fP
1718 /etc/dnf/repos.override.d/
1719 .UNINDENT
1720 .INDENT 0.0
1721 .TP
1722 .B \fBUser Repos Override Files\fP
1723 /etc/dnf/repos.override.d/20\-user\-overrides.repo
1724 .UNINDENT
1725 .INDENT 0.0
1726 .TP
1727 .B \fBDistribution Repos Override Directory\fP
1728 /usr/share/dnf5/repos.override.d/
1729 .UNINDENT
1730 .INDENT 0.0
1731 .TP
1732 .B \fBDistribution Repos Override Files\fP
1733 /usr/share/dnf5/repos.override.d/50\-something2.repo
1734 .UNINDENT
1735 .SH FILES
1736 .INDENT 0.0
1737 .TP
1738 .B \fBMain Configuration File\fP
1739 /etc/dnf/dnf.conf
1740 .UNINDENT
1741 .INDENT 0.0
1742 .TP
1743 .B \fBCache Files\fP
1744 /var/cache/libdnf5
1745 .UNINDENT
1746 .INDENT 0.0
1747 .TP
1748 .B \fBRepository Files\fP
1749 /etc/yum.repos.d/
1750 .UNINDENT
1751 .INDENT 0.0
1752 .TP
1753 .B \fBVariables\fP
1754 Any property named file in \fB/etc/dnf/vars\fP is turned into a variable named after the filename
1755 (or overrides any of the above variables but those set from commandline).
1756 Filenames may contain only alphanumeric characters and underscores and be in lowercase.
1757 Variables are also read from \fB/etc/yum/vars\fP for YUM compatibility reasons.
1758 .UNINDENT
1759 .SH DIRECTORIES
1760 .SS Repository Directories
1761 .sp
1762 Directories are listed in the order in which they are processed.
1763 .sp
1764 \fBNOTE:\fP
1765 .INDENT 0.0
1766 .INDENT 3.5
1767 Unlike overrides that modify an existing repository configuration,
1768 the configuration in these directories defines new repositories.
1769 It is not possible to define repositories with the same ID.
1770 If multiple repositories with the same ID are defined only the first configuration
1771 will be loaded. Loading the next one will log an error.
1772 .UNINDENT
1773 .UNINDENT
1774 .INDENT 0.0
1775 .TP
1776 .B \fBYUM Repositories Directory\fP
1777 /etc/yum.repos.d/
1778 .UNINDENT
1779 .INDENT 0.0
1780 .TP
1781 .B \fBDistribution Repositories Directory in /etc\fP
1782 /etc/distro.repos.d/
1783 .TP
1784 .B \fBDistribution Repositories Directory in /usr\fP
1785 /usr/share/dnf5/repos.d/
1786 .UNINDENT
1787 .SS Variables Directories
1788 .INDENT 0.0
1789 .TP
1790 .B \fBVariables Directory\fP
1791 /etc/dnf/vars/
1792 .UNINDENT
1793 .INDENT 0.0
1794 .TP
1795 .B \fBDistribution Variables Directory\fP
1796 /usr/share/dnf5/vars.d/
1797 .UNINDENT
1798 .SH SEE ALSO
1799 .INDENT 0.0
1800 .IP \(bu 2
1801 \fBdnf5(8)\fP, \fI\%DNF5 Command Reference\fP
1802 .IP \(bu 2
1803 \fBdnf5.conf\-vendorpolicy(5)\fP, \fI\%DNF5 Vendor Change Policy File Reference\fP
1804 .IP \(bu 2
1805 \fBdnf5.conf\-todo(5)\fP, \fI\%Options that are documented/implemented in DNF but not in DNF5\fP
1806 .IP \(bu 2
1807 \fBdnf5.conf\-deprecated(5)\fP, \fI\%Config Options that are deprecated in DNF5\fP
1808 .UNINDENT
1809 .SH AUTHOR
1810 See AUTHORS.md in dnf5 source distribution.
1811 .SH COPYRIGHT
1812 Contributors to the dnf5 project.
1813 .\" Generated by docutils manpage writer.
1814 .