1.2 DNF Configuration

The main configuration file for DNF is /etc/dnf/dnf.conf. The global definitions for DNF are located under the [main] section heading of the DNF configuration file. The following table describes the important directives for DNF.

Directive

Description

cachedir

Directory used to store downloaded packages.

debuglevel

Logging level, from 0 (none) to 10 (all).

exclude

A space separated list of packages to exclude from installs or updates, for example: exclude=VirtualBox-4.? kernel*.

gpgcheck

If set to 1, verify the authenticity of the packages by checking the GPG signatures. You might need to set gpgcheck to 0 if a package is unsigned, but you should be wary that the package could have been maliciously altered.

gpgkey

Path to the GPG public key file.

installonly_limit

Maximum number of versions that can be installed of any one package.

keepcache

If set to 0, remove packages after installation.

logfile

Path to the yum log file.

obsoletes

If set to 1, replace obsolete packages during upgrades.

plugins

If set to 1, enable plugins that extend the functionality of yum.

proxy

URL of a proxy server including the port number. See Section 1.2.1, “Configuring the Use of a Proxy Server”.

proxy_password

Password for authentication with a proxy server.

proxy_username

User name for authentication with a proxy server.

reposdir

Directories where yum should look for repository files with a .repo extension. The default directory is /etc/yum.repos.d.

See the dnf.conf(5) manual page for more information.

The following listing shows an example [main] section from the DNF configuration file.

[main]
cachedir=/var/cache/dnf
keepcache=0
debuglevel=2
logfile=/var/log/dnf.log
obsoletes=1
gpgkey=file://media/RPM-GPG-KEY
gpgcheck=1
plugins=1
installonly_limit=3

It is possible to define repositories below the [main] section in /etc/dnf/dnf.conf or in separate repository configuration files. By default, dnf expects any repository configuration files to be located in the /etc/yum.repos.d directory, unless you use the reposdir directive to define alternate directories.

Note that for backward-compatibility purposes, a symbolic link to /etc/dnf/dnf.conf is created at /etc/yum.conf. The configuration syntax is generally the same; although, some configuration options have been deprecated and some new configuration options have been added. See Oracle® Linux 8: Release Notes for Oracle Linux 8 for a breakdown of the differences between configuration options and syntax.