dnf.conf (5) - Linux Man Pages

dnf.conf: DNF Configuration Reference

NAME

dnf.conf - DNF Configuration Reference

DESCRIPTION

DNF by default uses the global configuration file at /etc/dnf/dnf.conf and all *.repo files found under /etc/yum.repos.d. The latter is typically used for repository configuration.

There are two types of sections in the configuration files: main and repository. Main defines all global configuration options. There should be only one main section. The repository sections define the configuration for each (remote or local) repository.

[MAIN] OPTIONS

best
boolean

When upgrading a package, always try to install its highest version available, even only to find out some of its deps are not satisfiable. Enable this if you want to experience broken dependencies in the repositories firsthand. The default is False.

clean_requirements_on_remove
boolean

Remove dependencies that are no longer used during dnf remove. A package only qualifies for removal via clean_requirements_on_remove if it was installed through DNF but not on explicit user request, i.e. it was pulled in as a dependency. The default is True.

debuglevel
integer

Debug messages output level, in the range 0 to 10. The higher the number the more debug output is put to stdout. Default is 2.

errorlevel
integer

Error messages output level, in the range 0 to 10. The higher the number the more error output is put to stderr. Default is 2. This is deprecated in DNF.

installonlypkgs
list

List of provide names of packages that should only ever be installed, never upgraded. Kernels in particular fall into this category.

installonly_limit
integer

Number of installonly packages allowed to be installed concurrently. Defaults to 3.

keepcache
boolean

Keep downloaded packages in the cache. The default is False.

metadata_timer_sync
time in seconds

The minimal period between two consecutive makecache timer runs. The command will stop immediately if it's less than this time period since its last run. Does not affect simple makecache run. Use 0 to completely disable automatic metadata synchronizing. The default corresponds to three hours.

pluginpath
list

List of directories that are searched for plugins to load. Plugins found in any of the directories in this configuration option are used. The default contains a Python version-specific path.

REPO OPTIONS

cost
integer

The relative cost of accessing this repository, defaulting to 1000. If the same package can be downloaded from two or more repositories, the repository with the lowest cost is preferred.

gpgkey
list of strings

URLs of a GPG key files that can be used for signing metadata and packages of this repository, empty by default. If a file can not be verified using the already imported keys, import of keys from this option is attempted and the keys are then used for verification.

priority
integer

The priority value of this repository, default is 99. If there is more than one candidate package for a particular operation, the one from a repo with the lowest priority value is picked, possibly despite being less convenient otherwise (e.g. by being a lower version).

skip_if_unavailable
boolean

If enabled, DNF will continue running and disable the repository that couldn't be contacted for any reason when downloading metadata. This option doesn't affect skipping of unavailable packages after dependency resolution. To check inaccessibility of repository use it in combination with refresh command line option. The default is True.

OPTIONS FOR BOTH [MAIN] AND REPO

Some options can be applied in either the main section, per repository, or in a combination. The value provided in the main section is used for all repositories as the default value and concrete repositories can override it in their configuration.

bandwidth
storage size

Total bandwidth available for downloading. Meaningful when used with the throttle option. Storage size is in bytes by default but can be specified with a unit of storage. Valid units are 'k', 'M', 'G'.

deltarpm
boolean

When enabled, DNF will save bandwidth by downloading much smaller delta RPM files, rebuilding them to RPM locally. However, this is quite CPU and I/O intensive. Default is True.

enablegroups
boolean

Determines whether DNF will allow the use of package groups for this repository. Default is True (package groups are allowed).

exclude
list

Exclude packages of this repository, specified by a name or a glob and separated by a comma, from all operations. Can be disabled using --disableexcludes command line switch.

fastestmirror
boolean

If enabled a metric is used to find the fastest available mirror. This overrides the order provided by the mirrorlist/metalink file itself. This file is often dynamically generated by the server to provide the best download speeds and enabling fastestmirror overrides this. The default is False.

gpgcheck
boolean

Whether to perform GPG signature check on packages found in this repository. The default is False.

include
list

Include packages of this repository, specified by a name or a glob and separated by a comma, from all operations. Inverse of exclude, DNF will exclude any package in the repo. that doesn't match this list. This works in conjunction with exclude and doesn't override it, so if you 'exclude=*.i386' and 'include=python*' then only packages starting with python that do not have an i386 arch. will be seen by DNF in this repo. Can be disabled using --disableexcludes command line switch.

ip_resolve
IP address type

Determines how DNF resolves host names. Set this to '4'/'IPv4' or '6'/'IPv6' to resolve to IPv4 or IPv6 addresses only. By default, DNF resolves to either addresses.

metadata_expire
time in seconds

The period after which the remote repository is checked for metadata update and in the positive case the local metadata cache is updated. The default corresponds to 48 hours. Set this to -1 or never to make the repo never considered expired.

minrate
storage size

This sets the low speed threshold in bytes per second. If the server is sending data at the same or slower speed than this value for at least timeout option seconds, DNF aborts the connection. The default is 0. Valid units are 'k', 'M', 'G'.

proxy
string

URL of a proxy server to connect through. If none is specified then direct connection is used (the default).

proxy_username
string

The username to use for connecting to the proxy server. Empty by default.

proxy_password
string

The password to use for connecting to the proxy server. Empty by default.

repo_gpgcheck
boolean

Whether to perform GPG signature check on this repository's metadata. The default is False.

sslverify
boolean

When enabled, remote SSL connections are verified. If the client can not be authenticated connecting fails and the given repo is not used further. On False, SSL connections can be used but are not verified. Default is True.

throttle
storage size

Limits the downloading speed. It might be an absolute value or a percentage, relative to the value of the bandwidth option option. 0 means no throttling (the default). The absolute value is in bytes by default but can be specified with a unit of storage. Valid units are 'k', 'M', 'G'.

timeout
time in seconds

Number of seconds to wait for a connection before timing out. Used in combination with minrate option option. Defaults to 30 seconds.

AUTHOR

See AUTHORS in DNF source distribution.

COPYRIGHT

2012-2014, Red Hat, Licensed under GPLv2+

SEE ALSO

dnf(8), DNF Command Reference