1DNF.CONF(5) DNF DNF.CONF(5)
2
3
4
6 dnf.conf - DNF Configuration Reference
7
9 DNF by default uses the global configuration file at /etc/dnf/dnf.conf
10 and all *.repo files found under /etc/yum.repos.d. The latter is typi‐
11 cally used for repository configuration and takes precedence over
12 global configuration.
13
14 The configuration file has INI format consisting of section declaration
15 and name=value options below each on separate line. There are two types
16 of sections in the configuration files: main and repository. Main sec‐
17 tion defines all global configuration options and should be only one.
18
19 The repository sections define the configuration for each (remote or
20 local) repository. The section name of the repository in brackets serve
21 as repo ID reference and should be unique across configuration files.
22 The allowed characters of repo ID string are lower and upper case
23 alphabetic letters, digits, -, _, . and :. The minimal repository con‐
24 figuration file should aside from repo ID consists of baseurl, metalink
25 or mirrorlist option definition.
26
28 Configuration options, namely best and skip_if_unavailable, can be set
29 in the DNF configuration file by your distribution to override the DNF
30 defaults.
31
33 arch string
34
35 The architecture used for installing packages. By default this
36 is auto-detected. Often used together with ignorearch option.
37
38 assumeno
39 boolean
40
41 If enabled dnf will assume No where it would normally prompt for
42 confirmation from user input. Default is False.
43
44 assumeyes
45 boolean
46
47 If enabled dnf will assume Yes where it would normally prompt
48 for confirmation from user input (see also defaultyes). Default
49 is False.
50
51 autocheck_running_kernel
52 boolean
53
54 Automatic check whether there is installed newer kernel module
55 with security update than currently running kernel. Default is
56 True.
57
58 basearch
59 string
60
61 The base architecture used for installing packages. By default
62 this is auto-detected.
63
64 best boolean
65
66 True instructs the solver to either use a package with the high‐
67 est available version or fail. On False, do not fail if the lat‐
68 est version cannot be installed and go with the lower version.
69 The default is True. Note this option in particular can be set
70 in your configuration file by your distribution.
71
72 cachedir
73 string
74
75 Path to a directory used by various DNF subsystems for storing
76 cache data. Has a reasonable root-writable default depending on
77 the distribution. DNF needs to be able to create files and
78 directories at this location.
79
80 cacheonly
81 boolean
82
83 If set to True DNF will run entirely from system cache, will not
84 update the cache and will use it even in case it is expired.
85 Default is False.
86
87 check_config_file_age
88 boolean
89
90 Specifies whether dnf should automatically expire metadata of
91 repos, which are older than their corresponding configuration
92 file (usually the dnf.conf file and the foo.repo file). Default
93 is True (perform the check). Expire of metadata is also affected
94 by metadata age. See also metadata_expire.
95
96 clean_requirements_on_remove
97 boolean
98
99 Remove dependencies that are no longer used during dnf remove. A
100 package only qualifies for removal via clean_require‐
101 ments_on_remove if it was installed through DNF but not on
102 explicit user request, i.e. it was pulled in as a dependency.
103 The default is True. (installonlypkgs are never automatically
104 removed.)
105
106 config_file_path
107 string
108
109 Path to the default main configuration file. Default is
110 /etc/dnf/dnf.conf.
111
112 debuglevel
113 integer
114
115 Debug messages output level, in the range 0 to 10. The higher
116 the number the more debug output is put to stdout. Default is 2.
117
118 debug_solver
119 boolean
120
121 Controls whether the libsolv debug files should be created when
122 solving the transaction. The debug files are created in the
123 ./debugdata directory. Default is False.
124
125 defaultyes
126 boolean
127
128 If enabled the default answer to user confirmation prompts will
129 be Yes. Not to be confused with assumeyes which will not prompt
130 at all. Default is False.
131
132 diskspacecheck
133 boolean
134
135 Controls wheather rpm shoud check available disk space during
136 the transaction. Default is True.
137
138 errorlevel
139 integer
140
141 Error messages output level, in the range 0 to 10. The higher
142 the number the more error output is put to stderr. Default is 3.
143 This is deprecated in DNF and overwritten by --verbose command‐
144 line option.
145
146 exit_on_lock
147 boolean
148
149 Should the dnf client exit immediately when something else has
150 the lock. Default is False.
151
152 gpgkey_dns_verification
153 boolean
154
155 Should the dnf attempt to automatically verify GPG verification
156 keys using the DNS system. This option requires libunbound to be
157 installed on the client system. This system has two main fea‐
158 tures. The first one is to check if any of the already installed
159 keys have been revoked. Automatic removal of the key is not yet
160 available, so it is up to the user, to remove revoked keys from
161 the system. The second feature is automatic verification of new
162 keys when a repository is added to the system. In interactive
163 mode, the result is written to the output as a suggestion to the
164 user. In non-interactive mode (i.e. when -y is used), this sys‐
165 tem will automatically accept keys that are available in the DNS
166 and are correctly signed using DNSSEC. It will also accept keys
167 that do not exist in the DNS system and their NON-existence is
168 cryptographically proven using DNSSEC. This is mainly to pre‐
169 serve backward compatibility. Default is False.
170
171 group_package_types
172 list
173
174 List of the following: optional, default, mandatory. Tells dnf
175 which type of packages in groups will be installed when
176 'groupinstall' is called. Default is: default, mandatory.
177
178 ignorearch
179 boolean
180
181 If set to True, RPM will allow attempts to install packages
182 incompatible with the CPU's architecture. Defaults to False.
183 Often used together with arch option.
184
185 installonlypkgs
186 list
187
188 List of provide names of packages that should only ever be
189 installed, never upgraded. Kernels in particular fall into this
190 category. These packages are never removed by dnf autoremove
191 even if they were installed as dependencies (see
192 clean_requirements_on_remove for auto removal details). This
193 option append the list values to the default installonlypkgs
194 list used by DNF. The number of kept package versions is regu‐
195 lated by installonly_limit.
196
197 installonly_limit
198 integer
199
200 Number of installonly packages allowed to be installed concur‐
201 rently. Defaults to 3. The minimal number of installonly pack‐
202 ages is 2. Value 0 or 1 means unlimited number of installonly
203 packages.
204
205 installroot
206 string
207
208 The root of the filesystem for all packaging operations. It
209 requires an absolute path. See also --installroot commandline
210 option.
211
212 install_weak_deps
213 boolean
214
215 When this option is set to True and a new package is about to be
216 installed, all packages linked by weak dependency relation (Rec‐
217 ommends or Supplements flags) with this package will be pulled
218 into the transaction. Default is True.
219
220 keepcache
221 boolean
222
223 Keeps downloaded packages in the cache when set to True. Even if
224 it is set to False and packages have not been installed they
225 will still persist until next successful transaction. The
226 default is False.
227
228 logdir string
229
230 Directory where the log files will be stored. Default is
231 /var/log.
232
233 log_rotate
234 integer
235
236 Log files are rotated log_rotate times before being removed. If
237 log_rotate is 0, the rotation is not performed. Default is 4.
238
239 log_size
240 storage size
241
242 Log files are rotated when they grow bigger than log_size
243 bytes. If log_size is 0, the rotation is not performed. The
244 default is 1 MB. Valid units are 'k', 'M', 'G'.
245
246 The size applies for individual log files, not the sum of all
247 log files. See also log_rotate.
248
249 metadata_timer_sync
250 time in seconds
251
252 The minimal period between two consecutive makecache timer runs.
253 The command will stop immediately if it's less than this time
254 period since its last run. Does not affect simple makecache run.
255 Use 0 to completely disable automatic metadata synchronizing.
256 The default corresponds to three hours. The value is rounded to
257 the next commenced hour.
258
259 module_platform_id
260 string
261
262 Set this to $name:$stream to override PLATFORM_ID detected from
263 /etc/os-release. It is necessary to perform a system upgrade
264 and switch to a new platform.
265
266 multilib_policy
267 string
268
269 Controls how multilib packages are treated during install opera‐
270 tions. Can either be "best" (the default) for the depsolver to
271 prefer packages which best match the system's architecture, or
272 "all" to install all available packages with compatible archi‐
273 tectures.
274
275 obsoletes
276 boolean
277
278 This option only has affect during an install/update. It enables
279 dnf's obsoletes processing logic, which means it makes dnf check
280 whether any dependencies of given package are no longer required
281 and removes them. Useful when doing distribution level
282 upgrades. Default is 'true'.
283
284 Command-line option: --obsoletes
285
286 persistdir
287 string
288
289 Directory where DNF stores its persistent data between runs.
290 Default is "/var/lib/dnf".
291
292 pluginconfpath
293 list
294
295 List of directories that are searched for plugin configurations
296 to load. All configuration files found in these directories,
297 that are named same as a plugin, are parsed. The default path is
298 /etc/dnf/plugins.
299
300 pluginpath
301 list
302
303 List of directories that are searched for plugins to load. Plug‐
304 ins found in any of the directories in this configuration option
305 are used. The default contains a Python version-specific path.
306
307 plugins
308 boolean
309
310 Controls whether the plugins are enabled. Default is True.
311
312 protected_packages
313 list
314
315 List of packages that DNF should never completely remove. They
316 are protected via Obsoletes as well as user/plugin removals.
317
318 The default is: dnf, glob:/etc/yum/protected.d/*.conf and
319 glob:/etc/dnf/protected.d/*.conf. So any packages which should
320 be protected can do so by including a file in /etc/dnf/pro‐
321 tected.d with their package name in it.
322
323 DNF will protect also the package corresponding to the running
324 version of the kernel.
325
326 releasever
327 string
328
329 Used for substitution of $releasever in the repository configu‐
330 ration. See also repo variables.
331
332 reposdir
333 list
334
335 DNF searches for repository configuration files in the paths
336 specified by reposdir. The behavior of reposdir could differ
337 when it is used along with --installroot option.
338
339 rpmverbosity
340 string
341
342 RPM debug scriptlet output level. One of: critical, emergency,
343 error, warn, info or debug. Default is info.
344
345 strict boolean
346
347 If disabled, all unavailable packages or packages with broken
348 dependencies given to DNF command will be skipped without rais‐
349 ing the error causing the whole operation to fail. Currently
350 works for install command only. The default is True.
351
352 tsflags
353 list
354
355 List of strings adding extra flags for the RPM transaction.
356
357 ┌─────────────┬────────────────────────────┐
358 │tsflag value │ RPM Transaction Flag │
359 ├─────────────┼────────────────────────────┤
360 │noscripts │ RPMTRANS_FLAG_NOSCRIPTS │
361 ├─────────────┼────────────────────────────┤
362 │test │ RPMTRANS_FLAG_TEST │
363 ├─────────────┼────────────────────────────┤
364 │notriggers │ RPMTRANS_FLAG_NOTRIGGERS │
365 ├─────────────┼────────────────────────────┤
366 │nodocs │ RPMTRANS_FLAG_NODOCS │
367 ├─────────────┼────────────────────────────┤
368 │justdb │ RPMTRANS_FLAG_JUSTDB │
369 ├─────────────┼────────────────────────────┤
370 │nocontexts │ RPMTRANS_FLAG_NOCONTEXTS │
371 ├─────────────┼────────────────────────────┤
372 │nocaps │ RPMTRANS_FLAG_NOCAPS │
373 ├─────────────┼────────────────────────────┤
374 │nocrypto │ RPMTRANS_FLAG_NOFILEDIGEST │
375 └─────────────┴────────────────────────────┘
376
377 The nocrypto option will also set the _RPMVSF_NOSIGNATURES and
378 _RPMVSF_NODIGESTS VS flags. The test option provides a transac‐
379 tion check without performing the transaction. It includes down‐
380 loading of packages, gpg keys check (including permanent import
381 of additional keys if necessary), and rpm check to prevent file
382 conflicts. The nocaps is supported with rpm-4.14 or later. When
383 nocaps is used but rpm doesn't support it, DNF only reports it
384 as an invalid tsflag.
385
386 upgrade_group_objects_upgrade
387 boolean
388
389 Set this to False to disable the automatic running of group
390 upgrade when running the upgrade command. Default is True (per‐
391 form the operation).
392
393 varsdir
394 list
395
396 List of directories where variables definition files are looked
397 for. Defaults to "/etc/dnf/vars", "/etc/yum/vars". See variable
398 files in Configuration reference.
399
400 zchunk boolean
401
402 Enables or disables the use of repository metadata compressed
403 using the zchunk format (if available). Default is True.
404
406 color string
407
408 Controls if DNF uses colored output on the command line. Possi‐
409 ble values: "auto", "never", "always". Default is "auto".
410
411 color_list_available_downgrade
412 color
413
414 Color of available packages that are older than installed pack‐
415 ages. The option is used during list operations.
416
417 color_list_available_install
418 color
419
420 Color of packages that are available for installation and none
421 of their versions in installed. The option is used during list
422 operations.
423
424 color_list_available_reinstall
425 color
426
427 Color of available packages that are identical to installed ver‐
428 sions and are available for reinstalls. The option is used dur‐
429 ing list operations.
430
431 color_list_available_upgrade
432 color
433
434 Color of available packages that are newer than installed pack‐
435 ages. The option is used during list operations.
436
437 color_list_installed_extra
438 color
439
440 Color of installed packages that do not have any version among
441 available packages. The option is used during list operations.
442
443 color_list_installed_newer
444 color
445
446 Color of installed packages that are newer than any version
447 among available packages. The option is used during list opera‐
448 tions.
449
450 color_list_installed_older
451 color
452
453 Color of installed packages that are older than any version
454 among available packages. The option is used during list opera‐
455 tions.
456
457 color_list_installed_reinstall
458 color
459
460 Color of installed packages that are among available packages
461 and can be reinstalled. The option is used during list opera‐
462 tions.
463
464 color_search_match
465 color
466
467 Color of patterns matched in search output.
468
469 color_update_installed
470 color
471
472 Color of removed packages. This option is used during display‐
473 ing transactions.
474
475 color_update_local
476 color
477
478 Color of local packages that are installed from the @commandline
479 repository. This option is used during displaying transactions.
480
481 color_update_remote
482 color
483
484 Color of packages that are installed/upgraded/downgraded from
485 remote repositories. This option is used during displaying
486 transactions.
487
489 baseurl
490 list
491
492 List of URLs for the repository. Defaults to [].
493
494 cost integer
495
496 The relative cost of accessing this repository, defaulting to
497 1000. This value is compared when the priorities of two reposi‐
498 tories are the same. The repository with the lowest cost is
499 picked. It is useful to make the library prefer on-disk reposi‐
500 tories to remote ones.
501
502 enabled
503 boolean
504
505 Include this repository as a package source. The default is
506 True.
507
508 gpgkey list of strings
509
510 URLs of a GPG key files that can be used for signing metadata
511 and packages of this repository, empty by default. If a file can
512 not be verified using the already imported keys, import of keys
513 from this option is attempted and the keys are then used for
514 verification.
515
516 metalink
517 string
518
519 URL of a metalink for the repository. Defaults to None.
520
521 mirrorlist
522 string
523
524 URL of a mirrorlist for the repository. Defaults to None.
525
526 module_hotfixes
527 boolean
528
529 Set this to True to disable module RPM filtering and make all
530 RPMs from the repository available. The default is False. This
531 allows user to create a repository with cherry-picked hotfixes
532 that are included in a package set on a modular system.
533
534 name string
535
536 A human-readable name of the repository. Defaults to the ID of
537 the repository.
538
539 priority
540 integer
541
542 The priority value of this repository, default is 99. If there
543 is more than one candidate package for a particular operation,
544 the one from a repo with the lowest priority value is picked,
545 possibly despite being less convenient otherwise (e.g. by being
546 a lower version).
547
548 type string
549
550 Type of repository metadata. Supported values are: rpm-md.
551 Aliases for rpm-md: rpm, repomd, rpmmd, yum, YUM.
552
554 Right side of every repo option can be enriched by the following vari‐
555 ables:
556
557 $arch
558 Refers to the system’s CPU architecture e.g, aarch64, i586, i686 and
559 x86_64.
560
561 $basearch
562 Refers to the base architecture of the system. For example, i686 and
563 i586 machines both have a base architecture of i386, and AMD64 and
564 Intel64 machines have a base architecture of x86_64.
565
566 $releasever
567 Refers to the release version of operating system which DNF derives
568 from information available in RPMDB.
569
570 In addition to these hard coded variables, user-defined ones can also
571 be used. They can be defined either via variable files, or by using
572 special environmental variables. The names of these variables must be
573 prefixed with DNF_VAR_ and they can only consist of alphanumeric char‐
574 acters and underscores:
575
576 $ DNF_VAR_MY_VARIABLE=value
577
579 Some options can be applied in either the main section, per repository,
580 or in a combination. The value provided in the main section is used for
581 all repositories as the default value, which repositories can then
582 override in their configuration.
583
584 bandwidth
585 storage size
586
587 Total bandwidth available for downloading. Meaningful when used
588 with the throttle option. Storage size is in bytes by default
589 but can be specified with a unit of storage. Valid units are
590 'k', 'M', 'G'.
591
592 countme
593 boolean
594
595 Determines whether a special flag should be added to a single,
596 randomly chosen metalink/mirrorlist query each week. This
597 allows the repository owner to estimate the number of systems
598 consuming it, by counting such queries over a week's time, which
599 is much more accurate than just counting unique IP addresses
600 (which is subject to both overcounting and undercounting due to
601 short DHCP leases and NAT, respectively).
602
603 The flag is a simple "countme=N" parameter appended to the met‐
604 alink and mirrorlist URL, where N is an integer representing the
605 "longevity" bucket this system belongs to. The following 4
606 buckets are defined, based on how many full weeks have passed
607 since the beginning of the week when this system was installed:
608 1 = first week, 2 = first month (2-4 weeks), 3 = six months
609 (5-24 weeks) and 4 = more than six months (> 24 weeks). This
610 information is meant to help distinguish short-lived installs
611 from long-term ones, and to gather other statistics about system
612 lifecycle.
613
614 Default is False.
615
616 deltarpm
617 boolean
618
619 When enabled, DNF will save bandwidth by downloading much
620 smaller delta RPM files, rebuilding them to RPM locally. How‐
621 ever, this is quite CPU and I/O intensive. Default is True.
622
623 deltarpm_percentage
624 integer
625
626 When the relative size of delta vs pkg is larger than this,
627 delta is not used. Default value is 75 (Deltas must be at least
628 25% smaller than the pkg). Use 0 to turn off delta rpm process‐
629 ing. Local repositories (with file:// baseurl) have delta rpms
630 turned off by default.
631
632 enablegroups
633 boolean
634
635 Determines whether DNF will allow the use of package groups for
636 this repository. Default is True (package groups are allowed).
637
638 excludepkgs
639 list
640
641 Exclude packages of this repository, specified by a name or a
642 glob and separated by a comma, from all operations. Can be dis‐
643 abled using --disableexcludes command line switch. Defaults to
644 [].
645
646 fastestmirror
647 boolean
648
649 If enabled a metric is used to find the fastest available mir‐
650 ror. This overrides the order provided by the mirrorlist/met‐
651 alink file itself. This file is often dynamically generated by
652 the server to provide the best download speeds and enabling
653 fastestmirror overrides this. The default is False.
654
655 gpgcheck
656 boolean
657
658 Whether to perform GPG signature check on packages found in this
659 repository. The default is False.
660
661 This option can only be used to strengthen the active RPM secu‐
662 rity policy set with the %_pkgverify_level macro (see the
663 /usr/lib/rpm/macros file for details). That means, if the macro
664 is set to 'signature' or 'all' and this option is False, it will
665 be overridden to True during DNF runtime, and a warning will be
666 printed. To squelch the warning, make sure this option is True
667 for every enabled repository, and also enable localpkg_gpgcheck.
668
669 includepkgs
670 list
671
672 Include packages of this repository, specified by a name or a
673 glob and separated by a comma, in all operations. Inverse of
674 excludepkgs, DNF will exclude any package in the repository that
675 doesn't match this list. This works in conjunction with
676 excludepkgs and doesn't override it, so if you 'excludep‐
677 kgs=*.i386' and 'includepkgs=python*' then only packages start‐
678 ing with python that do not have an i386 arch will be seen by
679 DNF in this repo. Can be disabled using --disableexcludes com‐
680 mand line switch. Defaults to [].
681
682 ip_resolve
683 IP address type
684
685 Determines how DNF resolves host names. Set this to '4'/'IPv4'
686 or '6'/'IPv6' to resolve to IPv4 or IPv6 addresses only. By
687 default, DNF resolves to either addresses.
688
689 localpkg_gpgcheck
690 boolean
691
692 Whether to perform a GPG signature check on local packages
693 (packages in a file, not in a repository). The default is
694 False. This option is subject to the active RPM security policy
695 (see gpgcheck for more details).
696
697 max_parallel_downloads
698 integer
699
700 Maximum number of simultaneous package downloads. Defaults to 3.
701
702 metadata_expire
703 time in seconds
704
705 The period after which the remote repository is checked for
706 metadata update and in the positive case the local metadata
707 cache is updated. The default corresponds to 48 hours. Set this
708 to -1 or never to make the repo never considered expired. Expire
709 of metadata can bee also triggered by change of timestamp of
710 configuration files (dnf.conf, <repo>.repo). See also
711 check_config_file_age.
712
713 minrate
714 storage size
715
716 This sets the low speed threshold in bytes per second. If the
717 server is sending data at the same or slower speed than this
718 value for at least timeout option seconds, DNF aborts the con‐
719 nection. The default is 1000. Valid units are 'k', 'M', 'G'.
720
721 password
722 string
723
724 The password to use for connecting to a repository with basic
725 HTTP authentication. Empty by default.
726
727 proxy string
728
729 URL of a proxy server to connect through. Set to an empty string
730 to disable the proxy setting inherited from the main section and
731 use direct connection instead. The expected format of this
732 option is <scheme>://<ip-or-hostname>[:port]. (For backward
733 compatibility, '_none_' can be used instead of the empty
734 string.)
735
736 Note: The curl environment variables (such as http_proxy) are
737 effective if this option is unset. See the curl man page for
738 details.
739
740 proxy_username
741 string
742
743 The username to use for connecting to the proxy server. Empty by
744 default.
745
746 proxy_password
747 string
748
749 The password to use for connecting to the proxy server. Empty by
750 default.
751
752 proxy_auth_method
753 string
754
755 The authentication method used by the proxy server. Valid values
756 are
757
758 ┌──────────┬────────────────────────────┐
759 │method │ meaning │
760 ├──────────┼────────────────────────────┤
761 │basic │ HTTP Basic authentication │
762 └──────────┴────────────────────────────┘
763
764
765 │digest │ HTTP Digest authentication │
766 ├──────────┼────────────────────────────┤
767 │negotiate │ HTTP Negotiate (SPNEGO) │
768 │ │ authentication │
769 ├──────────┼────────────────────────────┤
770 │ntlm │ HTTP NTLM authentication │
771 ├──────────┼────────────────────────────┤
772 │digest_ie │ HTTP Digest authentication │
773 │ │ with an IE flavor │
774 ├──────────┼────────────────────────────┤
775 │ntlm_wb │ NTLM delegating to winbind │
776 │ │ helper │
777 ├──────────┼────────────────────────────┤
778 │none │ None auth method │
779 ├──────────┼────────────────────────────┤
780 │any │ All suitable methods │
781 └──────────┴────────────────────────────┘
782
783 Defaults to any
784
785 repo_gpgcheck
786 boolean
787
788 Whether to perform GPG signature check on this repository's
789 metadata. The default is False.
790
791 retries
792 integer
793
794 Set the number of total retries for downloading packages. The
795 number is accumulative, so e.g. for retries=10, dnf will fail
796 after any package download fails for eleventh time. Setting this
797 to 0 makes dnf try forever. Default is 10.
798
799 skip_if_unavailable
800 boolean
801
802 If enabled, DNF will continue running and disable the repository
803 that couldn't be synchronized for any reason. This option
804 doesn't affect skipping of unavailable packages after dependency
805 resolution. To check inaccessibility of repository use it in
806 combination with refresh command line option. The default is
807 False. Note this option in particular can be set in your con‐
808 figuration file by your distribution.
809
810 sslcacert
811 string
812
813 Path to the directory or file containing the certificate author‐
814 ities to verify SSL certificates. Empty by default - uses sys‐
815 tem default.
816
817 sslverify
818 boolean
819
820 When enabled, remote SSL certificates are verified. If the
821 client can not be authenticated, connecting fails and the repos‐
822 itory is not used any further. If False, SSL connections can be
823 used, but certificates are not verified. Default is True.
824
825 sslclientcert
826 string
827
828 Path to the SSL client certificate used to connect to remote
829 sites. Empty by default.
830
831 sslclientkey
832 string
833
834 Path to the SSL client key used to connect to remote sites.
835 Empty by default.
836
837 throttle
838 storage size
839
840 Limits the downloading speed. It might be an absolute value or a
841 percentage, relative to the value of the bandwidth option
842 option. 0 means no throttling (the default). The absolute value
843 is in bytes by default but can be specified with a unit of stor‐
844 age. Valid units are 'k', 'M', 'G'.
845
846 timeout
847 time in seconds
848
849 Number of seconds to wait for a connection before timing out.
850 Used in combination with minrate option option. Defaults to 30
851 seconds.
852
853 username
854 string
855
856 The username to use for connecting to repo with basic HTTP
857 authentication. Empty by default.
858
859 user_agent
860 string
861
862 The User-Agent string to include in HTTP requests sent by DNF.
863 Defaults to
864
865 libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)
866
867 where NAME, VERSION_ID and VARIANT_ID are OS identifiers read
868 from the os-release(5) file, and OS and BASEARCH are the canoni‐
869 cal OS name and base architecture, respectively. Example:
870
871 libdnf (Fedora 31; server; Linux.x86_64)
872
874 boolean
875 This is a data type with only two possible values.
876
877 One of following options can be used: 1, 0, True, False, yes, no
878
879 integer
880 It is a whole number that can be written without a fractional
881 component.
882
883 list It is an option that could represent one or more strings sepa‐
884 rated by space or comma characters.
885
886 string It is a sequence of symbols or digits without any whitespace
887 character.
888
889 color A string describing color and modifiers separated with a comma,
890 for example "red,bold".
891
892 · Colors: black, blue, cyan, green, magenta, red, white, yellow
893
894 · Modifiers: bold, blink, dim, normal, reverse, underline
895
897 Cache Files
898 /var/cache/dnf
899
900 Main Configuration File
901 /etc/dnf/dnf.conf
902
903 Repository
904 /etc/yum.repos.d/
905
906 Variables
907 Any properly named file in /etc/dnf/vars is turned into a vari‐
908 able named after the filename (or overrides any of the above
909 variables but those set from commandline). Filenames may contain
910 only alphanumeric characters and underscores and be in lower‐
911 case.
912
914 · dnf(8), DNF Command Reference
915
917 See AUTHORS in DNF source distribution.
918
920 2012-2020, Red Hat, Licensed under GPLv2+
921
922
923
924
9254.2.21 Apr 08, 2020 DNF.CONF(5)