Debian Codegraph @

upstream/debian-unstable/man5/dnf5.conf.5

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