Debian Codegraph @

upstream/opensuse-tumbleweed/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" "Feb 19, 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 set in your configuration file by
108 your distribution\&.
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 .TE
675 .sp
676 The \fBnocrypto\fP option will also set the \fB_RPMVSF_NOSIGNATURES\fP and
677 \fB_RPMVSF_NODIGESTS\fP VS flags.
678 .sp
679 The \fBtest\fP option provides a transaction check without performing the transaction.
680 It includes downloading of packages, OpenPGP keys check (including permanent import of
681 additional keys if necessary), and rpm check to prevent file conflicts.
682 .sp
683 The \fBnocaps\fP is supported with rpm\-4.14 or later. When \fBnocaps\fP is used but rpm
684 doesn\(aqt support it, DNF5 only reports it as an invalid tsflag.
685 .sp
686 Default: empty.
687 .UNINDENT
688 .sp
689 \fBuse_host_config\fP
690 .INDENT 0.0
691 .INDENT 3.5
692 Use configuration files and variable definitions from the host system rather
693 than the installroot.
694 See \%<#\:installroot-misc-ref-label> \fBdnf5\-installroot(7)\fP for more info.
695 .sp
696 Default: \fBFalse\fP\&.
697 .UNINDENT
698 .UNINDENT
699 .INDENT 0.0
700 .TP
701 .B \fBvarsdir\fP
702 list
703 .sp
704 List of directories where variables definition files are looked for.
705 .sp
706 See variable files in Configuration reference.
707 .sp
708 Default: \fB/etc/dnf/vars\fP\&.
709 .UNINDENT
710 .INDENT 0.0
711 .TP
712 .B \fBzchunk\fP
713 boolean
714 .sp
715 If enabled, repository metadata are compressed using the zchunk format (if available).
716 .sp
717 Default: \fBTrue\fP\&.
718 .UNINDENT
719 .SH [MAIN] OPTIONS - COLORS
720 .INDENT 0.0
721 .TP
722 .B \fBcolor_list_available_upgrade\fP
723 color
724 .sp
725 Color of available packages that are newer than installed packages.
726 The option is used during list operations.
727 .sp
728 Default: \fBbold,blue\fP\&.
729 .UNINDENT
730 .INDENT 0.0
731 .TP
732 .B \fBcolor_list_available_downgrade\fP
733 color
734 .sp
735 Color of available packages that are older than installed packages.
736 The option is used during list operations.
737 .sp
738 Default: \fBdim,magenta\fP\&.
739 .UNINDENT
740 .INDENT 0.0
741 .TP
742 .B \fBcolor_list_available_reinstall\fP
743 color
744 .sp
745 Color of available packages that are identical to installed versions and are available for reinstalls.
746 The option is used during list operations.
747 .sp
748 Default: \fBbold,green\fP\&.
749 .UNINDENT
750 .INDENT 0.0
751 .TP
752 .B \fBcolor_list_available_install\fP
753 color
754 .sp
755 Color of packages that are available for installation and none of their versions in installed.
756 The option is used during list operations.
757 .sp
758 Default: \fBbold,cyan\fP\&.
759 .UNINDENT
760 .INDENT 0.0
761 .TP
762 .B \fBcolor_update_installed\fP
763 color
764 .sp
765 Color of removed packages.
766 This option is used during displaying transactions.
767 .sp
768 Default: \fBdim,red\fP\&.
769 .UNINDENT
770 .INDENT 0.0
771 .TP
772 .B \fBcolor_update_local\fP
773 color
774 .sp
775 Color of local packages that are installed from the @commandline repository.
776 This option is used during displaying transactions.
777 .sp
778 Default: \fBdim,green\fP\&.
779 .UNINDENT
780 .INDENT 0.0
781 .TP
782 .B \fBcolor_update_remote\fP
783 color
784 .sp
785 Color of packages that are installed/upgraded/downgraded from remote repositories.
786 This option is used during displaying transactions.
787 .sp
788 Default: \fBbold,green\fP\&.
789 .UNINDENT
790 .INDENT 0.0
791 .TP
792 .B \fBcolor_search_match\fP
793 color
794 .sp
795 Color of patterns matched in search output.
796 .sp
797 Default: \fBbold,magenta\fP\&.
798 .UNINDENT
799 .SH REPO OPTIONS
800 .INDENT 0.0
801 .TP
802 .B \fBbaseurl\fP
803 list
804 .sp
805 List of URLs for the repository.
806 .sp
807 Default [].
808 .sp
809 URLs are tried in the listed order (equivalent to yum’s “failovermethod=priority” behaviour).
810 .UNINDENT
811 .INDENT 0.0
812 .TP
813 .B \fBcost\fP
814 integer
815 .sp
816 The relative cost of accessing this repository, defaulting to 1000. This
817 value is compared when the priorities of two repositories are the same. The
818 repository with the lowest cost is picked. It is useful to make the library
819 prefer on\-disk repositories to remote ones.
820 .UNINDENT
821 .INDENT 0.0
822 .TP
823 .B \fBenabled\fP
824 boolean
825 .sp
826 Include this repository as a package source.
827 .sp
828 Default: \fBTrue\fP\&.
829 .UNINDENT
830 .INDENT 0.0
831 .TP
832 .B \fBgpgkey\fP
833 list
834 .sp
835 URLs of a OpenPGP key files that can be used for signing metadata and packages
836 of this repository. If a file can not be verified using
837 the already imported keys, import of keys from this option is attempted and
838 the keys are then used for verification.
839 .sp
840 Default: \fB[]\fP
841 .UNINDENT
842 .INDENT 0.0
843 .TP
844 .B \fBmetalink\fP
845 string
846 .sp
847 URL of a metalink for the repository.
848 .sp
849 Default: \fBNone\fP\&.
850 .UNINDENT
851 .INDENT 0.0
852 .TP
853 .B \fBmirrorlist\fP
854 string
855 .sp
856 URL of a mirrorlist for the repository.
857 .sp
858 Default: \fBNone\fP\&.
859 .UNINDENT
860 .INDENT 0.0
861 .TP
862 .B \fBname\fP
863 string
864 .sp
865 A human\-readable name of the repository. Defaults to the ID of the repository.
866 .UNINDENT
867 .INDENT 0.0
868 .TP
869 .B \fBpriority\fP
870 integer
871 .sp
872 The priority value of this repository. If there is more than
873 one candidate package for a particular operation, the one from a repo with
874 the lowest priority value is picked, possibly despite being less convenient
875 otherwise (e.g. by being a lower version).
876 .sp
877 Default: 99
878 .UNINDENT
879 .INDENT 0.0
880 .TP
881 .B \fBtype\fP
882 string
883 .sp
884 Type of repository metadata. Supported values are: \fBrpm\-md\fP\&. Aliases for
885 \fBrpm\-md\fP: \fBrpm\fP, \fBrepomd\fP, \fBrpmmd\fP, \fByum\fP, \fBYUM\fP\&.
886 .sp
887 Default: empty.
888 .UNINDENT
889 .SH SOURCE AND DEBUGINFO REPOSITORY NAMES
890 .sp
891 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.
892 .sp
893 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.
894 .SH REPO VARIABLES
895 .sp
896 Right side of every repo option can be enriched by the following variables:
897 .sp
898 \fB$arch\fP
899 .INDENT 0.0
900 .INDENT 3.5
901 Refers to the system’s CPU architecture e.g, aarch64, i586, i686 and x86_64.
902 .UNINDENT
903 .UNINDENT
904 .sp
905 \fB$basearch\fP
906 .INDENT 0.0
907 .INDENT 3.5
908 Refers to the base architecture of the system. For example, i686 and i586 machines
909 both have a base architecture of i386, and AMD64 and Intel64 machines have a base architecture of x86_64.
910 .UNINDENT
911 .UNINDENT
912 .sp
913 \fB$releasever\fP
914 .INDENT 0.0
915 .INDENT 3.5
916 Refers to the release version of operating system which DNF5 derives from information available in RPMDB.
917 .UNINDENT
918 .UNINDENT
919 .sp
920 In addition to these hard coded variables, user\-defined ones can also be used.
921 They can be defined either via variable files, or by using special environmental variables.
922 The names of these variables must be prefixed with DNF_VAR_ and they can only consist of alphanumeric characters
923 and underscores:
924 .INDENT 0.0
925 .INDENT 3.5
926 .sp
927 .EX
928 $ DNF_VAR_MY_VARIABLE=value
929 .EE
930 .UNINDENT
931 .UNINDENT
932 .sp
933 To use such variable in your repository configuration remove the prefix. E.g.:
934 .INDENT 0.0
935 .INDENT 3.5
936 .sp
937 .EX
938 [myrepo]
939 baseurl=https://example.site/pub/fedora/$MY_VARIABLE/releases/$releasever
940 .EE
941 .UNINDENT
942 .UNINDENT
943 .sp
944 Note that it is not possible to override the \fBarch\fP and \fBbasearch\fP variables using either variable files or
945 environmental variables.
946 .sp
947 Although users are encouraged to use named variables, the numbered environmental variables
948 \fBDNF0\fP \- \fBDNF9\fP are still supported:
949 .INDENT 0.0
950 .INDENT 3.5
951 .sp
952 .EX
953 $ DNF1=value
954
955 [myrepo]
956 baseurl=https://example.site/pub/fedora/$DNF1/releases/$releasever
957 .EE
958 .UNINDENT
959 .UNINDENT
960 .SH OPTIONS FOR BOTH [MAIN] AND REPO
961 .sp
962 Some options can be applied in either the main section, per repository, or in a
963 combination. The value provided in the main section is used for all repositories
964 as the default value, which repositories can then override in their
965 configuration.
966 .INDENT 0.0
967 .TP
968 .B \fBbandwidth\fP
969 storage size
970 .sp
971 Total bandwidth available for downloading.
972 Meaningful when used with the throttle option\&.
973 .sp
974 Default: \fB0\fP\&.
975 .UNINDENT
976 .INDENT 0.0
977 .TP
978 .B \fBbuild_cache\fP
979 boolean
980 .sp
981 If enabled, DNF5 will save libsolv cache generated from downloaded metadata
982 to cachedir. These solv files are loaded during subsequent runs which
983 significantly speeds up DNF5.
984 .sp
985 Default: \fBTrue\fP\&.
986 .UNINDENT
987 .INDENT 0.0
988 .TP
989 .B \fBcountme\fP
990 boolean
991 .sp
992 When enabled, one (and only one) HTTP GET request for the metalink file
993 will be selected at random every week to carry a special URL flag.
994 .sp
995 This flag allows the repository provider to estimate the number of systems
996 consuming the repository, by counting such requests over a week\(aqs time.
997 This method is more accurate than just counting unique IP addresses (which
998 is subject to both overcounting and undercounting due to short DHCP leases
999 and NAT, respectively).
1000 .sp
1001 This is \fInot\fP an out\-of\-band HTTP request made for this purpose alone.
1002 Only requests initiated by DNF during normal operation, such as to check
1003 for metadata updates, can get this flag.
1004 .sp
1005 The flag is a simple \(dqcountme=N\(dq parameter appended to the metalink URL
1006 where N is an integer representing the age \(dqbucket\(dq this system belongs to.
1007 Four buckets are defined, based on how many full weeks have passed since
1008 the installation of a system:
1009 .TS
1010 box center;
1011 l|l.
1012 T{
1013 bucket
1014 T} T{
1015 system age
1016 T}
1017 _
1018 T{
1019 1
1020 T} T{
1021 first week
1022 T}
1023 _
1024 T{
1025 2
1026 T} T{
1027 first month (2 \- 4 weeks)
1028 T}
1029 _
1030 T{
1031 3
1032 T} T{
1033 first 6 months (5 \- 24 weeks)
1034 T}
1035 _
1036 T{
1037 4
1038 T} T{
1039 more than 6 months (> 24 weeks)
1040 T}
1041 .TE
1042 .sp
1043 This number is meant to help distinguish short\-lived (throwaway) machines
1044 from long\-term installs and get a better picture of how systems are used
1045 over time.
1046 .sp
1047 To determine a system\(aqs installation time (\(dqepoch\(dq), the \fBmachine\-id(5)\fP
1048 file\(aqs modification time is used as the single source of truth. This file
1049 is semantically tied to the system\(aqs lifetime as it\(aqs typically populated
1050 at installation time or during the first boot by an installer tool or init
1051 system (such as \fBsystemd(1)\fP), respectively, and remains unchanged.
1052 .sp
1053 If the file is empty or missing (such as in containers), the time of the
1054 very first request made using the expanded metalink URL (i.e. with any
1055 repository variables such as \fB$releasever\fP substituted) that carried the
1056 flag is declared as the epoch.
1057 .sp
1058 If no metalink URL is defined for this repository but a mirrorlist URL is,
1059 the latter is used for this purpose instead.
1060 .sp
1061 Default: \fBFalse\fP\&.
1062 .UNINDENT
1063 .INDENT 0.0
1064 .TP
1065 .B \fBdisable_excludes\fP
1066 list
1067 .sp
1068 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.
1069 .UNINDENT
1070 .INDENT 0.0
1071 .TP
1072 .B \fBenablegroups\fP
1073 boolean
1074 .sp
1075 If enabled, DNF5 will allow the use of package groups.
1076 .sp
1077 Default: \fBTrue\fP\&.
1078 .UNINDENT
1079 .INDENT 0.0
1080 .TP
1081 .B \fBexcludepkgs\fP
1082 list
1083 .sp
1084 Exclude packages of this repository, specified by a name or a glob and
1085 separated by a comma, from all operations.
1086 .sp
1087 Can be disabled using \fBdisable_excludes\fP config option.
1088 .sp
1089 Default: \fB[]\fP\&.
1090 .UNINDENT
1091 .INDENT 0.0
1092 .TP
1093 .B \fBfastestmirror\fP
1094 boolean
1095 .sp
1096 If enabled, TCP socket latency is used to find the closest available mirror.
1097 A mirror is then selected at random with less than twice the lowest latency for load balancing purposes.
1098 This overrides the order provided by the mirrorlist/metalink file itself,
1099 and does not take into consideration mirrorlist parameters such as mirror bandwidth nor preferred mirrors for client IP addresses.
1100 .sp
1101 Default: \fBFalse\fP\&.
1102 .UNINDENT
1103 .INDENT 0.0
1104 .TP
1105 .B \fBpkg_gpgcheck\fP
1106 boolean
1107 .sp
1108 Whether to perform OpenPGP signature check on packages found in this repository.
1109 .sp
1110 The default is False.
1111 .sp
1112 Doesn\(aqt apply for packages passed directly as arguments, as they are not in any repository,
1113 see localpkg_gpgcheck\&.
1114 .sp
1115 Due to compatibility \fIgpgcheck\fP option is supported as well but \fIpkg_gpgcheck\fP is preferred.
1116 .UNINDENT
1117 .INDENT 0.0
1118 .TP
1119 .B \fBincludepkgs\fP
1120 list
1121 .sp
1122 Include packages of this repository, specified by a name or a glob and separated by a comma, in all operations.
1123 .sp
1124 Inverse of excludepkgs, DNF5 will exclude any package in the repository
1125 that doesn\(aqt match this list.
1126 .sp
1127 This works in conjunction with excludepkgs and doesn\(aqt override it,
1128 so if you \(aqexcludepkgs=*.i386\(aq and \(aqincludepkgs=python*\(aq then only packages starting with python
1129 that do not have an i386 arch will be seen by DNF5 in this repo.
1130 .sp
1131 Can be disabled using \fBdisable_excludes\fP config option.
1132 .sp
1133 Default: \fB[]\fP\&.
1134 .UNINDENT
1135 .INDENT 0.0
1136 .TP
1137 .B \fBip_resolve\fP
1138 ip address
1139 .sp
1140 Determines how DNF5 resolves host names. Set this to \fB4\fP, \fBIPv4\fP, \fB6\fP, \fBIPv6\fP
1141 to resolve to IPv4 or IPv6 addresses only.
1142 .sp
1143 Default: \fBwhatever\fP\&.
1144 .UNINDENT
1145 .INDENT 0.0
1146 .TP
1147 .B \fBlocalpkg_gpgcheck\fP
1148 boolean
1149 .sp
1150 If enabled, DNF5 will perform a OpenPGP signature check on local packages (packages in a file, not in a repository).
1151 .sp
1152 Default: \fBFalse\fP\&.
1153 .UNINDENT
1154 .INDENT 0.0
1155 .TP
1156 .B \fBmax_parallel_downloads\fP
1157 integer
1158 .sp
1159 Maximum number of simultaneous downloads. Max is \fB20\fP\&.
1160 .sp
1161 Default: \fB3\fP\&.
1162 .UNINDENT
1163 .INDENT 0.0
1164 .TP
1165 .B \fBmax_downloads_per_mirror\fP
1166 integer
1167 .sp
1168 Maximum number of simultaneous downloads per mirror. Max is \fB20\fP\&.
1169 .sp
1170 Default: \fB3\fP\&.
1171 .UNINDENT
1172 .INDENT 0.0
1173 .TP
1174 .B \fBmetadata_expire\fP
1175 time in seconds
1176 .sp
1177 The period after which the remote repository is checked for metadata update and in the positive
1178 case the local metadata cache is updated.
1179 It can be \fB\-1\fP or \fBnever\fP to make the repo never considered expired.
1180 .sp
1181 Expire of metadata can be also triggered by change of timestamp of configuration files
1182 (\fBdnf.conf\fP, \fB<repo>.repo\fP).
1183 .sp
1184 See also check_config_file_age\&.
1185 .sp
1186 Default: \fB60 * 60 * 48\fP, 48 hours.
1187 .UNINDENT
1188 .INDENT 0.0
1189 .TP
1190 .B \fBminrate\fP
1191 storage size
1192 .sp
1193 Sets the low speed threshold in bytes per second.
1194 If the server is sending data at the same or slower speed than this value for at least
1195 timeout option seconds, DNF5 aborts the connection.
1196 .sp
1197 Default: \fB1000\fP\&.
1198 .UNINDENT
1199 .INDENT 0.0
1200 .TP
1201 .B \fBpassword\fP
1202 string
1203 .sp
1204 The password used to connect to a repository with basic HTTP authentication.
1205 .sp
1206 Default: empty.
1207 .UNINDENT
1208 .INDENT 0.0
1209 .TP
1210 .B \fBproxy\fP
1211 string
1212 .sp
1213 URL of a proxy server to connect through.
1214 .sp
1215 Set to an empty string in the repository configuration to disable proxy
1216 setting inherited from the main section. The expected format of this option is
1217 \fB<scheme>://<ip\-or\-hostname>[:port]\fP\&.
1218 (For backward compatibility, \(aq_none_\(aq can be used instead of the empty string.)
1219 .sp
1220 Default: empty.
1221 .sp
1222 \fBNote:\fP
1223 .INDENT 7.0
1224 .INDENT 3.5
1225 The curl environment variables (such as \fBhttp_proxy\fP) are effective if this option is unset
1226 (or \(aq_none_\(aq is set in the repository configuration). See the \fBcurl\fP man page for details.
1227 .UNINDENT
1228 .UNINDENT
1229 .UNINDENT
1230 .INDENT 0.0
1231 .TP
1232 .B \fBproxy_username\fP
1233 string
1234 .sp
1235 The username to use for connecting to the proxy server.
1236 .sp
1237 Default: empty.
1238 .UNINDENT
1239 .INDENT 0.0
1240 .TP
1241 .B \fBproxy_password\fP
1242 string
1243 .sp
1244 The password to use for connecting to the proxy server.
1245 .sp
1246 Default: empty.
1247 .UNINDENT
1248 .INDENT 0.0
1249 .TP
1250 .B \fBproxy_auth_method\fP
1251 string
1252 .sp
1253 The authentication method used by the proxy server. Valid values are
1254 .TS
1255 box center;
1256 l|l.
1257 T{
1258 method
1259 T} T{
1260 meaning
1261 T}
1262 _
1263 T{
1264 \fBbasic\fP
1265 T} T{
1266 HTTP Basic authentication
1267 T}
1268 _
1269 T{
1270 \fBdigest\fP
1271 T} T{
1272 HTTP Digest authentication
1273 T}
1274 _
1275 T{
1276 \fBnegotiate\fP
1277 T} T{
1278 HTTP Negotiate (SPNEGO) authentication
1279 T}
1280 _
1281 T{
1282 \fBntlm\fP
1283 T} T{
1284 HTTP NTLM authentication
1285 T}
1286 _
1287 T{
1288 \fBdigest_ie\fP
1289 T} T{
1290 HTTP Digest authentication with an IE flavor
1291 T}
1292 _
1293 T{
1294 \fBntlm_wb\fP
1295 T} T{
1296 NTLM delegating to winbind helper
1297 T}
1298 _
1299 T{
1300 \fBnone\fP
1301 T} T{
1302 None auth method
1303 T}
1304 _
1305 T{
1306 \fBany\fP
1307 T} T{
1308 All suitable methods
1309 T}
1310 .TE
1311 .sp
1312 Default: \fBany\fP\&.
1313 .UNINDENT
1314 .INDENT 0.0
1315 .TP
1316 .B \fBproxy_sslcacert\fP
1317 string
1318 .sp
1319 Path to the file containing the certificate authorities to verify proxy SSL certificates.
1320 .sp
1321 Default: empty, uses system default.
1322 .UNINDENT
1323 .INDENT 0.0
1324 .TP
1325 .B \fBproxy_sslclientcert\fP
1326 string
1327 .sp
1328 Path to the SSL client certificate used to connect to proxy server.
1329 .sp
1330 Default: empty.
1331 .UNINDENT
1332 .INDENT 0.0
1333 .TP
1334 .B \fBproxy_sslclientkey\fP
1335 string
1336 .sp
1337 Path to the SSL client key used to connect to proxy server.
1338 .sp
1339 Default: empty.
1340 .UNINDENT
1341 .INDENT 0.0
1342 .TP
1343 .B \fBproxy_sslverify\fP
1344 boolean
1345 .sp
1346 If enabled, proxy SSL certificates are verified. If the client can not be authenticated, connecting fails and the
1347 repository is not used any further. If \fBFalse\fP, SSL connections can be used, but certificates are not verified.
1348 .sp
1349 Default: \fBTrue\fP\&.
1350 .UNINDENT
1351 .INDENT 0.0
1352 .TP
1353 .B \fBrepo_gpgcheck\fP
1354 boolean
1355 .sp
1356 If enabled, DNF5 will perform OpenPGP signature check on this repository\(aqs metadata.
1357 .sp
1358 \fBNote:\fP
1359 .INDENT 7.0
1360 .INDENT 3.5
1361 OpenPGP keys for this check are stored separately from OpenPGP keys used in package signature
1362 verification. Furthermore, they are also stored separately for each repository.
1363 .sp
1364 This means that DNF5 may ask to import the same key multiple times. For example, when a key was
1365 already imported for package signature verification and this option is turned on, it may be needed
1366 to import it again for the repository.
1367 .UNINDENT
1368 .UNINDENT
1369 .sp
1370 Default: \fBFalse\fP\&.
1371 .UNINDENT
1372 .INDENT 0.0
1373 .TP
1374 .B \fBskip_if_unavailable\fP
1375 boolean
1376 .sp
1377 If enabled, DNF5 will continue running and disable the repository that couldn\(aqt be synchronized
1378 for any reason. This option doesn\(aqt affect skipping of unavailable packages after dependency
1379 resolution. To check inaccessibility of repository use it in combination with
1380 refresh command line option\&.
1381 .sp
1382 Default: \fBFalse\fP\&.
1383 .sp
1384 \fBNote:\fP
1385 .INDENT 7.0
1386 .INDENT 3.5
1387 this option in particular can be set in your configuration file
1388 by your distribution\&.
1389 .UNINDENT
1390 .UNINDENT
1391 .UNINDENT
1392 .INDENT 0.0
1393 .TP
1394 .B \fBsslcacert\fP
1395 string
1396 .sp
1397 Path to the file containing the certificate authorities to verify SSL certificates.
1398 .sp
1399 Default: empty, uses system default.
1400 .UNINDENT
1401 .INDENT 0.0
1402 .TP
1403 .B \fBsslclientcert\fP
1404 string
1405 .sp
1406 Path to the SSL client certificate used to connect to remote sites.
1407 .sp
1408 Default: empty.
1409 .UNINDENT
1410 .INDENT 0.0
1411 .TP
1412 .B \fBsslclientkey\fP
1413 string
1414 .sp
1415 Path to the SSL client key used to connect to remote sites.
1416 .sp
1417 Default: empty.
1418 .UNINDENT
1419 .INDENT 0.0
1420 .TP
1421 .B \fBsslverify\fP
1422 boolean
1423 .sp
1424 If enabled, remote SSL certificates are verified. If the client can not be authenticated,
1425 connecting fails and the repository is not used any further.
1426 If disabled, SSL connections can be used, but certificates are not verified.
1427 .sp
1428 Default: \fBTrue\fP\&.
1429 .UNINDENT
1430 .INDENT 0.0
1431 .TP
1432 .B \fBthrottle\fP
1433 storage size
1434 .sp
1435 Limits the downloading speed. It might be an absolute value or a percentage, relative to the value of the
1436 bandwidth option option. \fB0\fP means no throttling.
1437 .sp
1438 Default: \fB0\fP\&.
1439 .UNINDENT
1440 .INDENT 0.0
1441 .TP
1442 .B \fBtimeout\fP
1443 time in seconds
1444 .sp
1445 Number of seconds to wait for a connection before timing out. Used in combination with
1446 minrate option option.
1447 .sp
1448 Default: \fB30\fP\&.
1449 .UNINDENT
1450 .INDENT 0.0
1451 .TP
1452 .B \fBusername\fP
1453 string
1454 .sp
1455 The username to use for connecting to repo with basic HTTP authentication.
1456 .sp
1457 Default: empty.
1458 .UNINDENT
1459 .INDENT 0.0
1460 .TP
1461 .B \fBuser_agent\fP
1462 string
1463 .sp
1464 The User\-Agent string to include in HTTP requests sent by DNF5.
1465 .sp
1466 Default:
1467 .INDENT 7.0
1468 .INDENT 3.5
1469 .sp
1470 .EX
1471 libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)
1472 .EE
1473 .UNINDENT
1474 .UNINDENT
1475 .sp
1476 \fBNote:\fP
1477 .INDENT 7.0
1478 .INDENT 3.5
1479 \fBNAME\fP, \fBVERSION_ID\fP and \fBVARIANT_ID\fP are OS identifiers read from the
1480 \fBos\-release(5)\fP file, and \fBOS\fP and \fBBASEARCH\fP are the canonical OS
1481 name and base architecture, respectively.
1482 Example:
1483 .INDENT 0.0
1484 .INDENT 3.5
1485 .sp
1486 .EX
1487 libdnf (Fedora 39; server; Linux.x86_64)
1488 .EE
1489 .UNINDENT
1490 .UNINDENT
1491 .UNINDENT
1492 .UNINDENT
1493 .UNINDENT
1494 .SH TYPES OF OPTIONS
1495 .INDENT 0.0
1496 .TP
1497 .B \fBboolean\fP
1498 Data type with only two possible values.
1499 .sp
1500 One of following options can be used: \fB1\fP, \fB0\fP, \fBTrue\fP, \fBFalse\fP, \fByes\fP, \fBno\fP\&.
1501 .UNINDENT
1502 .INDENT 0.0
1503 .TP
1504 .B \fBcolor\fP
1505 String describing color and modifiers separated with a comma, for example \fBred,bold\fP\&.
1506 .INDENT 7.0
1507 .IP \(bu 2
1508 Colors: \fBblack\fP, \fBblue\fP, \fBcyan\fP, \fBgreen\fP, \fBmagenta\fP, \fBred\fP, \fBwhite\fP, \fByellow\fP\&.
1509 .IP \(bu 2
1510 Modifiers: \fBbold\fP, \fBblink\fP, \fBdim\fP, \fBnormal\fP, \fBreverse\fP, \fBunderline\fP\&.
1511 .UNINDENT
1512 .UNINDENT
1513 .INDENT 0.0
1514 .TP
1515 .B \fBinteger\fP
1516 Whole number that can be written without a fractional component.
1517 .UNINDENT
1518 .INDENT 0.0
1519 .TP
1520 .B \fBip address type\fP
1521 String describing ip address types.
1522 .sp
1523 One of the following options can be used: \fB4\fP, \fBIPv4\fP, \fB6\fP, \fBIPv6\fP\&.
1524 .UNINDENT
1525 .INDENT 0.0
1526 .TP
1527 .B \fBlist\fP
1528 String representing one or more strings separated by space or comma characters.
1529 The backslash \fB\(aq\e\(aq\fP can be used to escape any character, allowing it to be included literally in the individual strings.
1530 .sp
1531 Example: \fB\(aqitem1,item2\e,with\e,commas,item3\e with\e spaces item4\(aq\fP
1532 .UNINDENT
1533 .INDENT 0.0
1534 .TP
1535 .B \fBstorage size\fP
1536 String representing storage sizes formed by an integer and a unit.
1537 .sp
1538 Valid units are \fBk\fP, \fBM\fP, \fBG\fP\&.
1539 .UNINDENT
1540 .INDENT 0.0
1541 .TP
1542 .B \fBstring\fP
1543 It is a sequence of symbols or digits without any whitespace character.
1544 .UNINDENT
1545 .INDENT 0.0
1546 .TP
1547 .B \fBtime in seconds\fP
1548 String representing time units in seconds. Can be set to \fB\-1\fP or \fBnever\fP\&.
1549 .UNINDENT
1550 .SH DROP-IN CONFIGURATION DIRECTORIES
1551 .sp
1552 \fIDNF5\fP loads configuration options that are defined in the main
1553 configuration file, user configuration
1554 files and distribution configuration
1555 files\&.
1556 .sp
1557 The configuration files are processed following this order:
1558 .INDENT 0.0
1559 .IP 1. 3
1560 Configuration files are alphabetically sorted in a list of names from the
1561 distribution configuration directory\&. If
1562 a file with the same name is present in both directories, only the file from
1563 the user configuration directory is added to the list. The
1564 distribution file is then masked by the user file.
1565 .IP 2. 3
1566 Options are retrieved in order from the list The configuration from the next
1567 file overrides the previous one. The last option wins.
1568 .UNINDENT
1569 .SS Example of configuration files
1570 .sp
1571 User configuration files:
1572 .INDENT 0.0
1573 .IP \(bu 2
1574 /etc/dnf/dnf.conf
1575 .IP \(bu 2
1576 /etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
1577 .IP \(bu 2
1578 /etc/dnf/libdnf5.conf.d/60\-something.conf
1579 .IP \(bu 2
1580 /etc/dnf/libdnf5.conf.d/80\-user\-settings.conf
1581 .UNINDENT
1582 .sp
1583 Distribution configuration files:
1584 .INDENT 0.0
1585 .IP \(bu 2
1586 /usr/share/dnf5/libdnf.conf.d/50\-something.conf
1587 .IP \(bu 2
1588 /usr/share/dnf5/libdnf.conf.d/60\-something.conf
1589 .IP \(bu 2
1590 /usr/share/dnf5/libdnf.conf.d/90\-something.conf
1591 .UNINDENT
1592 .sp
1593 Resulting file loading order by default
1594 (/usr/share/dnf5/libdnf.conf.d/60\-something.conf is skipped, masked by
1595 the user file /etc/dnf/libdnf5.conf.d/60\-something.conf):
1596 .INDENT 0.0
1597 .IP 1. 3
1598 /etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
1599 .IP 2. 3
1600 /usr/share/dnf5/libdnf.conf.d/50\-something.conf
1601 .IP 3. 3
1602 /etc/dnf/libdnf5.conf.d/60\-something.conf
1603 .IP 4. 3
1604 /etc/dnf/libdnf5.conf.d/80\-user\-settings.conf
1605 .IP 5. 3
1606 /usr/share/dnf5/libdnf.conf.d/90\-something.conf
1607 .IP 6. 3
1608 /etc/dnf/dnf.conf
1609 .UNINDENT
1610 .SS Files and directories
1611 .INDENT 0.0
1612 .TP
1613 .B \fBUser Configuration Directory\fP
1614 /etc/dnf/libdnf5.conf.d/
1615 .UNINDENT
1616 .INDENT 0.0
1617 .TP
1618 .B \fBUser Configuration Files\fP
1619 /etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
1620 .UNINDENT
1621 .INDENT 0.0
1622 .TP
1623 .B \fBDistribution Configuration Directory\fP
1624 /usr/share/dnf5/libdnf.conf.d/
1625 .UNINDENT
1626 .INDENT 0.0
1627 .TP
1628 .B \fBDistribution Configuration Files\fP
1629 /usr/share/dnf5/libdnf.conf.d/50\-something.conf
1630 .UNINDENT
1631 .SH DROP-IN REPO DIRECTORIES
1632 .sp
1633 After the repository configurations are loaded other repo configurations can be overloaded from the directories
1634 user repos override directory
1635 and distribution repos override directory\&.
1636 .sp
1637 The format of the files inside the directories is the same as the format of the repository configuration files.
1638 The options in the overridden files can modify existing repos but cannot create new repositories.
1639 .sp
1640 Override files support globs in the repository ID in order to support bulk modifications of repository parameters.
1641 .sp
1642 The repository overrides are processed following this order:
1643 .INDENT 0.0
1644 .IP 1. 3
1645 Files from \fB/usr/share/dnf5/repos.override.d/\fP and \fB/etc/dnf5/repos.override.d/\fP are loaded in an alphabetically
1646 sorted list. In case files have the same name, the file from \fB/etc/dnf5/repos.override.d/\fP is used.
1647 This implies the list has only unique filenames. This also implies that the repository configuration files can be
1648 simply masked by creating a file with the same name in the \fB/etc\fP override directory.
1649 .IP 2. 3
1650 The options from the files are applied in the order they are loaded. The last option wins.
1651 .UNINDENT
1652 .sp
1653 \fBNote:\fP
1654 .INDENT 0.0
1655 .INDENT 3.5
1656 See also the documentation for Config\-manager Command \%<#\:config-manager-plugin-ref-label> to see where the overrides are used.
1657 .UNINDENT
1658 .UNINDENT
1659 .SS Example configuration
1660 .INDENT 0.0
1661 .INDENT 3.5
1662 .sp
1663 .EX
1664 # Enable \(gaskip_if_unavailable\(ga for all repositories
1665 [*]
1666 skip_if_unavailable = true
1667
1668 # And then disable \(gaskip_if_unavailable\(ga for repositories with id prefix \(dqfedora\(dq
1669 [fedora*]
1670 skip_if_unavailable = false
1671 .EE
1672 .UNINDENT
1673 .UNINDENT
1674 .SS Example of configuration files
1675 .sp
1676 This example shows the order in which override files are processed.
1677 .sp
1678 Files with user repos overrides:
1679 .INDENT 0.0
1680 .IP \(bu 2
1681 /etc/dnf/repos.override.d/20\-user\-overrides.repo
1682 .IP \(bu 2
1683 /etc/dnf/repos.override.d/60\-something2.repo
1684 .IP \(bu 2
1685 /etc/dnf/repos.override.d/80\-user\-overrides.repo
1686 .IP \(bu 2
1687 /etc/dnf/repos.override.d/99\-config\-manager.repo
1688 .UNINDENT
1689 .sp
1690 Files with distribution repos overrides:
1691 .INDENT 0.0
1692 .IP \(bu 2
1693 /usr/share/dnf5/repos.override.d/50\-something2.repo
1694 .IP \(bu 2
1695 /usr/share/dnf5/repos.override.d/60\-something2.repo
1696 .IP \(bu 2
1697 /usr/share/dnf5/repos.override.d/90\-something2.repo
1698 .UNINDENT
1699 .sp
1700 Resulting file processing order:
1701 .INDENT 0.0
1702 .IP 1. 3
1703 /etc/dnf/repos.override.d/20\-user\-overrides.repo
1704 .IP 2. 3
1705 /usr/share/dnf5/repos.override.d/50\-something2.repo
1706 .IP 3. 3
1707 /etc/dnf/repos.override.d/60\-something2.repo
1708 .IP 4. 3
1709 /etc/dnf/repos.override.d/80\-user\-overrides.repo
1710 .IP 5. 3
1711 /usr/share/dnf5/repos.override.d/90\-something2.repo
1712 .IP 6. 3
1713 /etc/dnf/repos.override.d/99\-config\-manager.repo
1714 .UNINDENT
1715 .SS Files and directories
1716 .INDENT 0.0
1717 .TP
1718 .B \fBUser Repos Override Directory\fP
1719 /etc/dnf/repos.override.d/
1720 .UNINDENT
1721 .INDENT 0.0
1722 .TP
1723 .B \fBUser Repos Override Files\fP
1724 /etc/dnf/repos.override.d/20\-user\-overrides.repo
1725 .UNINDENT
1726 .INDENT 0.0
1727 .TP
1728 .B \fBDistribution Repos Override Directory\fP
1729 /usr/share/dnf5/repos.override.d/
1730 .UNINDENT
1731 .INDENT 0.0
1732 .TP
1733 .B \fBDistribution Repos Override Files\fP
1734 /usr/share/dnf5/repos.override.d/50\-something2.repo
1735 .UNINDENT
1736 .SH FILES
1737 .INDENT 0.0
1738 .TP
1739 .B \fBMain Configuration File\fP
1740 /etc/dnf/dnf.conf
1741 .UNINDENT
1742 .INDENT 0.0
1743 .TP
1744 .B \fBCache Files\fP
1745 /var/cache/libdnf5
1746 .UNINDENT
1747 .INDENT 0.0
1748 .TP
1749 .B \fBRepository Files\fP
1750 /etc/yum.repos.d/
1751 .UNINDENT
1752 .INDENT 0.0
1753 .TP
1754 .B \fBVariables\fP
1755 Any property named file in \fB/etc/dnf/vars\fP is turned into a variable named after the filename
1756 (or overrides any of the above variables but those set from commandline).
1757 Filenames may contain only alphanumeric characters and underscores and be in lowercase.
1758 Variables are also read from \fB/etc/yum/vars\fP for YUM compatibility reasons.
1759 .UNINDENT
1760 .SH DIRECTORIES
1761 .SS Repository Directories
1762 .sp
1763 Directories are listed in the order in which they are processed.
1764 .sp
1765 \fBNote:\fP
1766 .INDENT 0.0
1767 .INDENT 3.5
1768 Unlike overrides that modify an existing repository configuration,
1769 the configuration in these directories defines new repositories.
1770 It is not possible to define repositories with the same ID.
1771 If multiple repositories with the same ID are defined only the first configuration
1772 will be loaded. Loading the next one will log an error.
1773 .UNINDENT
1774 .UNINDENT
1775 .INDENT 0.0
1776 .TP
1777 .B \fBYUM Repositories Directory\fP
1778 /etc/yum.repos.d/
1779 .UNINDENT
1780 .INDENT 0.0
1781 .TP
1782 .B \fBDistribution Repositories Directory in /etc\fP
1783 /etc/distro.repos.d/
1784 .TP
1785 .B \fBDistribution Repositories Directory in /usr\fP
1786 /usr/share/dnf5/repos.d/
1787 .UNINDENT
1788 .SS Variables Directories
1789 .INDENT 0.0
1790 .TP
1791 .B \fBVariables Directory\fP
1792 /etc/dnf/vars/
1793 .UNINDENT
1794 .INDENT 0.0
1795 .TP
1796 .B \fBDistribution Variables Directory\fP
1797 /usr/share/dnf5/vars.d/
1798 .UNINDENT
1799 .SH SEE ALSO
1800 .INDENT 0.0
1801 .IP \(bu 2
1802 \fBdnf5(8)\fP, DNF5 Command Reference \%<#\:command-ref-label>
1803 .IP \(bu 2
1804 \fBdnf5.conf\-vendorpolicy(5)\fP, DNF5 Vendor Change Policy File Reference \%<#\:dnf5-vendor-change-policy-label>
1805 .IP \(bu 2
1806 \fBdnf5.conf\-todo(5)\fP, Options that are documented/implemented in DNF but not in DNF5 \%<#\:dnf5-conf-todo-label>
1807 .IP \(bu 2
1808 \fBdnf5.conf\-deprecated(5)\fP, Config Options that are deprecated in DNF5 \%<#\:dnf5-conf-deprecated-label>
1809 .UNINDENT
1810 .SH Author
1811 See AUTHORS.md in dnf5 source distribution.
1812 .SH Copyright
1813 Contributors to the dnf5 project.
1814 .\" End of generated man page.