1DNF.CONF(5)                           DNF                          DNF.CONF(5)
2
3
4

NAME

6       dnf.conf - DNF Configuration Reference
7

DESCRIPTION

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

DISTRIBUTION-SPECIFIC CONFIGURATION

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

[MAIN] OPTIONS

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

[MAIN] OPTIONS - COLORS

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

REPO OPTIONS

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

REPO VARIABLES

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

OPTIONS FOR BOTH [MAIN] AND REPO

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

TYPES OF OPTIONS

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

FILES

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

SEE ALSO

914       · dnf(8), DNF Command Reference
915

AUTHOR

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)
Impressum