'\" t
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "DNF5.CONF" "5" "Apr 18, 2025" "" "dnf5"
.SH NAME
dnf5.conf \- DNF5 Configuration Reference
.SH DESCRIPTION
.sp
\fIDNF5\fP by default uses the global configuration file at /etc/dnf/dnf.conf.
.sp
The configuration file has INI format consisting of section declaration and name=value options below each on separate
line. There are two types of sections in the configuration files: main and repository.  Main  section  defines all
global configuration options and should be only one.
.sp
The repository  sections  define  the configuration for each (remote or local) repository. The section name of the
repository in brackets serve as repo ID reference and should be unique  across  configuration  files.  The  allowed
characters  of  repo  ID  string  are  lower and upper case alphabetic letters, digits, \-, _, .  and :. The minimal
repository configuration file should aside from repo ID consists of baseurl, metalink or mirrorlist option  definition.
.SH [MAIN] OPTIONS
.INDENT 0.0
.TP
.B \fBallow_downgrade\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 allows downgrading packages while resolving dependencies.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBallow_vendor_change\fP
\fI\%boolean\fP
.sp
If disabled DNF5 will stick to vendor when upgrading or downgrading rpms.
.sp
Default: \fBTrue\fP\&.
.sp
\fBWARNING:\fP
.INDENT 7.0
.INDENT 3.5
This option is currently not supported for \fIdowngrade\fP and \fIdistro\-sync\fP commands
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBassumeno\fP
\fI\%boolean\fP
.sp
If enabled DNF5 will assume \fBNo\fP where it would normally prompt for confirmation from user input
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBassumeyes\fP
\fI\%boolean\fP
.sp
If enabled DNF5 will assume \fBYes\fP where it would normally prompt for
confirmation from user input (see also \fI\%defaultyes\fP).
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBbest\fP
\fI\%boolean\fP
.sp
If \fBTrue\fP, instructs the solver to either use a package with the highest
available version or fail. If \fBFalse\fP, do not fail if the latest version
cannot be installed and go with the lower version.
.sp
Default: \fBTrue\fP\&.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
This option in particular can be set in your configuration file by
your distribution\&.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBcachedir\fP
\fI\%string\fP
.sp
Path to a directory used by various DNF5 subsystems for storing cache data
including repositories metadata and downloaded packages.
Has a reasonable root\-writable default depending on the distribution. DNF5
needs to be able to create files and directories at this location.
.sp
Regular user default: \fB~/.cache/libdnf5\fP\&.
.sp
For superuser the value is overwritten by system_cachedir option.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcacheonly\fP
\fI\%string\fP
.sp
Can be \fBall\fP, \fBmetadata\fP, \fBnone\fP\&.
.sp
If set to \fBall\fP DNF5 will run entirely from system cache, will not update
the cache and will use the system cache even if it is expired.
.sp
If set to \fBmetadata\fP DNF5 will cache metadata only.
.sp
Default: \fBnone\fP\&.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
API Notes: Must be set before repository objects are created. Plugins must set
this in the pre_config hook. Later changes are ignored.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBcheck_config_file_age\fP
\fI\%boolean\fP
.sp
If enabled DNF5 should automatically expire metadata of repos, which are older than
their corresponding configuration file (usually the dnf.conf file and the foo.repo file).
.sp
Default: \fBTrue\fP\&.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
Expire of metadata is also affected by metadata age. See also
.sp
\fI\%metadata_expire\fP\&.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBclean_requirements_on_remove\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will remove dependencies that are no longer used during \fBdnf remove\fP\&.
A package only qualifies for removal via \fBclean_requirements_on_remove\fP if it was
installed through DNF5 but not on explicit user request, i.e. it was pulled in as a dependency.
.sp
\fI\%installonlypkgs\fP are never automatically removed.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBdebugdir\fP
\fI\%string\fP
.sp
Location where libsolv debug files will be created when enabled
by debug_solver\&.
.sp
Default \fI\&./debugdata\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBdebug_solver\fP
\fI\%boolean\fP
.sp
If enabled, libsolv debug files will be created when solving the
transaction. The debug files are created in the debugdir directory.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBdefaultyes\fP
\fI\%boolean\fP
.sp
If enabled, the default answer to user confirmation prompts will be \fBYes\fP\&.
Not to be confused with \fI\%assumeyes\fP which will not prompt at all.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBdestdir\fP
\fI\%string\fP
.sp
Redirect downloaded packages to provided directory.
.sp
Default: <package repository \fI\%cachedir\fP>/packages
.UNINDENT
.INDENT 0.0
.TP
.B \fBexclude_from_weak\fP
\fI\%list\fP
.sp
Prevent installing packages as weak dependencies (recommends or
supplements). The packages can be specified by a name or a glob and
separated by a comma.
.sp
Defaults to [].
.UNINDENT
.INDENT 0.0
.TP
.B \fBexclude_from_weak_autodetect\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will autodetect unmet weak dependencies (recommends or
supplements) of packages installed on the system. Providers of these weak
dependencies will not be installed by dnf as weak dependencies any more
(they will still be installed if pulled in as a regular dependency).
.sp
Defaults to true.
.UNINDENT
.INDENT 0.0
.TP
.B \fBgroup_package_types\fP
\fI\%list\fP
.sp
List of the following: \fBoptional\fP, \fBdefault\fP, \fBmandatory\fP or \fBconditional\fP\&.
.sp
Tells DNF5 which type of packages in groups will be installed when \(aqgroup install <group\-spec>\(aq
or \(aqinstall @<group\-spec>\(aq is called.
.sp
Default: \fBdefault, mandatory, conditional\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBignorearch\fP
\fI\%boolean\fP
.sp
If enabled, RPM will allow attempts to install packages incompatible with the CPU\(aqs architecture.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBinstallonlypkgs\fP
\fI\%list\fP
.sp
List of provide names of packages that should only ever be installed, never
upgraded. Kernels in particular fall into this category.
These packages are never removed by \fBdnf autoremove\fP even if they were
installed as dependencies (see
\fI\%clean_requirements_on_remove\fP
for auto removal details).
This option append the list values to the default installonlypkgs list used
by DNF5. The number of kept package versions is regulated
by \fI\%installonly_limit\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBinstallonly_limit\fP
\fI\%integer\fP
.sp
Number of \fI\%installonly packages\fP allowed to be installed
concurrently.
.sp
\fB1\fP is explicitly not allowed since it complicates kernel upgrades due to protection of
the running kernel from removal.
.sp
Minimum is \fB2\fP\&.
.sp
\fB0\fP means unlimited number of installonly packages.
.sp
Default: \fB3\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBinstallroot\fP
\fI\%string\fP
.sp
The root of the filesystem for all packaging operations.
It requires an absolute path.
See also \fI\%\-\-installroot commandline option\fP\&.
.sp
Default: \fB/\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBinstall_weak_deps\fP
\fI\%boolean\fP
.sp
If enabled, when a new package is about to be installed, all packages linked by weak dependency
relation (Recommends or Supplements flags) with this package will be pulled into the transaction.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBkeepcache\fP
\fI\%boolean\fP
.sp
If enabled, keeps downloaded packages in the cache. If disabled cache will persist
until the next successful transaction even if no packages have been installed.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBlogdir\fP
\fI\%string\fP
.sp
Directory where the log files will be stored.
.sp
Regular user default: \fB~/.local/state\fP\&.
.sp
Superuser default: \fB/var/log\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBlog_rotate\fP
\fI\%integer\fP
.sp
Log files are rotated \fBlog_rotate\fP times before being removed.
If \fBlog_rotate\fP is \fB0\fP, the rotation is not performed.
.sp
Default: \fB4\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBlog_size\fP
\fI\%storage size\fP
.sp
Log  files are rotated when they grow bigger than \fBlog_size\fP bytes. If
\fBlog_size\fP is \fB0\fP, the rotation is not performed.
.sp
The size applies for individual log files, not the sum of all log files.
See also \fI\%log_rotate\fP\&.
.sp
Default: \fB1M\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBmodule_platform_id\fP
\fI\%string\fP
.sp
Set this to \fB$name:$stream\fP to override \fBPLATFORM_ID\fP detected from \fB/etc/os\-release\fP\&.
It is necessary to perform a system upgrade and switch to a new platform.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBmodule_stream_switch\fP
\fI\%boolean\fP
.sp
If enabled, allows switching enabled streams of a module.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBmultilib_policy\fP
\fI\%string\fP
.sp
Controls how multilib packages are treated during install operations.
.sp
Can either be \fBbest\fP for the depsolver to prefer packages which best match the system\(aqs
architecture, or \fBall\fP to install packages for all available architectures.
.sp
Default: \fBbest\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBobsoletes\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 uses obsoletes processing logic, which means it checks whether
any dependencies of given package are no longer required and removes them.
.sp
Useful when doing distribution level upgrades.
.sp
It has effect during install/upgrade processes.
.sp
Command\-line option: \fI\%\-\-obsoletes\fP
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBoptional_metadata_types\fP
\fI\%list\fP
.sp
List of the following: \fBcomps\fP, \fBfilelists\fP, \fBother\fP, \fBpresto\fP, \fBupdateinfo\fP, \fBall\fP
.sp
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.
.sp
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.
.sp
Default: \fBcomps,updateinfo\fP
.UNINDENT
.INDENT 0.0
.TP
.B \fBpersistdir\fP
\fI\%string\fP
.sp
Directory where DNF5 stores its persistent data between runs.
.sp
Default: \fB/var/lib/dnf\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBpluginconfpath\fP
\fI\%list\fP
.sp
List of directories that are searched for libdnf5 plugin configurations to load.
.sp
All configuration files found in these directories, that are named same as a
plugin, are parsed.
.sp
Default: \fB/etc/dnf/libdnf5\-plugins\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBpluginpath\fP
\fI\%list\fP
.sp
List of directories that are searched for libdnf5 plugins to load. Plugins found in
\fIany of the directories\fP in this configuration option are used.
.sp
Default: \fB/usr/lib64/libdnf5/plugins/\fP
.UNINDENT
.INDENT 0.0
.TP
.B \fBplugins\fP
\fI\%boolean\fP
.sp
If enabled, libdnf5 plugins are enabled.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBprotected_packages\fP
\fI\%list\fP
.sp
This append list option contains names of packages that DNF5 should never completely remove.
.sp
They are protected via Obsoletes as well as user/plugin removals.
.sp
Default: \fBdnf5,glob:/etc/dnf/protected.d/*.conf\fP\&.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
Any packages which should be protected can do so by including a file in \fB/etc/dnf/protected.d\fP
with their  package name in it.
.sp
DNF5 will protect also the package corresponding to the running version of the kernel. See also
\fI\%protect_running_kernel\fP option.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBprotect_running_kernel\fP
\fI\%boolean\fP
.sp
Controls whether the package corresponding to the running version of kernel is protected from removal.
.sp
Default: \fBTrue\fP\&.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
YUM compatibility option
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBrecent\fP
\fI\%integer\fP
.sp
Sets the time period in days used for the \fB\-\-recent\fP option in the \fI\%repoquery\fP,
\fI\%info\fP and \fI\%list\fP commands.
.sp
Default: 7
.UNINDENT
.INDENT 0.0
.TP
.B \fBreposdir\fP
\fI\%list\fP
.sp
Repository configuration files locations.
.sp
The behavior of \fBreposdir\fP could differ when it is used
along with \-\fI\%\-installroot\fP option.
.sp
Default: [\fB/etc/yum.repos.d\fP, \fB/etc/distro.repos.d\fP, \fB/usr/share/dnf5/repos.d\fP]
.UNINDENT
.INDENT 0.0
.TP
.B \fBskip_broken\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will skip uninstallable packages instead of failing while
resolving dependencies.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBskip_unavailable\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will skip unavailable packages instead of failing while
preparing rpm transactions.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.sp
\fBsystem_cachedir\fP
.INDENT 0.0
.INDENT 3.5
\fI\%string\fP
.sp
For superuser overwrites the \fI\%cachedir\fP option value.
.sp
Allows to differentiate user and superuser cachedir.
.sp
Default: \fB/var/cache/libdnf5\fP\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBsystem_state_dir\fP
\fI\%string\fP
.sp
System state files location. See \fBdnf5\-system\-state(7)\fP, \fI\%system state\fP for details.
.sp
Default: \fB/usr/lib/sysimage/libdnf5\fP\&.
.UNINDENT
.sp
\fBtransaction_history_dir\fP
.INDENT 0.0
.INDENT 3.5
\fI\%string\fP
.sp
History database location.
.sp
By default it has the same value as system_state_dir\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBtsflags\fP
\fI\%list\fP
.sp
List of strings adding extra flags for the RPM transaction.
.TS
box center;
l|l.
T{
tsflag value
T}	T{
RPM Transaction Flag
T}
_
T{
\fBnoscripts\fP
T}	T{
\fBRPMTRANS_FLAG_NOSCRIPTS\fP
T}
_
T{
\fBtest\fP
T}	T{
\fBRPMTRANS_FLAG_TEST\fP
T}
_
T{
\fBnotriggers\fP
T}	T{
\fBRPMTRANS_FLAG_NOTRIGGERS\fP
T}
_
T{
\fBnodocs\fP
T}	T{
\fBRPMTRANS_FLAG_NODOCS\fP
T}
_
T{
\fBjustdb\fP
T}	T{
\fBRPMTRANS_FLAG_JUSTDB\fP
T}
_
T{
\fBnocontexts\fP
T}	T{
\fBRPMTRANS_FLAG_NOCONTEXTS\fP
T}
_
T{
\fBnocaps\fP
T}	T{
\fBRPMTRANS_FLAG_NOCAPS\fP
T}
_
T{
\fBnocrypto\fP
T}	T{
\fBRPMTRANS_FLAG_NOFILEDIGEST\fP
T}
_
T{
\fBdeploops\fP
T}	T{
\fBRPMTRANS_FLAG_DEPLOOPS\fP
T}
.TE
.sp
The \fBnocrypto\fP option will also set the \fB_RPMVSF_NOSIGNATURES\fP and
\fB_RPMVSF_NODIGESTS\fP VS flags.
.sp
The \fBtest\fP option provides a transaction check without performing the transaction.
It includes downloading of packages, OpenPGP keys check (including permanent import of
additional keys if necessary), and rpm check to prevent file conflicts.
.sp
The \fBnocaps\fP is supported with rpm\-4.14 or later. When \fBnocaps\fP is used but rpm
doesn\(aqt support it, DNF5 only reports it as an invalid tsflag.
.sp
Default: empty.
.UNINDENT
.sp
\fBuse_host_config\fP
.INDENT 0.0
.INDENT 3.5
Use configuration files and variable definitions from the host system rather
than the installroot.
\fI\%See\fP \fBdnf5\-installroot(7)\fP for more info.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBvarsdir\fP
\fI\%list\fP
.sp
List of directories where variables definition files are looked for.
.sp
See \fI\%variable files\fP in Configuration reference.
.sp
Default: \fB/etc/dnf/vars\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBzchunk\fP
\fI\%boolean\fP
.sp
If enabled, repository metadata are compressed using the zchunk format (if available).
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.SH [MAIN] OPTIONS - COLORS
.INDENT 0.0
.TP
.B \fBcolor_list_available_upgrade\fP
\fI\%color\fP
.sp
Color of available packages that are newer than installed packages.
The option is used during list operations.
.sp
Default: \fBbold,blue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor_list_available_downgrade\fP
\fI\%color\fP
.sp
Color of available packages that are older than installed packages.
The option is used during list operations.
.sp
Default: \fBdim,magenta\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor_list_available_reinstall\fP
\fI\%color\fP
.sp
Color of available packages that are identical to installed versions and are available for reinstalls.
The option is used during list operations.
.sp
Default: \fBbold,green\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor_list_available_install\fP
\fI\%color\fP
.sp
Color of packages that are available for installation and none of their versions in installed.
The option is used during list operations.
.sp
Default: \fBbold,cyan\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor_update_installed\fP
\fI\%color\fP
.sp
Color of removed packages.
This option is used during displaying transactions.
.sp
Default: \fBdim,red\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor_update_label\fP
\fI\%color\fP
.sp
Color of local packages that are installed from the @commandline repository.
This option is used during displaying transactions.
.sp
Default: \fBdim,green\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor_update_remote\fP
\fI\%color\fP
.sp
Color of packages that are installed/upgraded/downgraded from remote repositories.
This option is used during displaying transactions.
.sp
Default: \fBbold,green\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor_search_match\fP
\fI\%color\fP
.sp
Color of patterns matched in search output.
.sp
Default: \fBbold,magenta\fP\&.
.UNINDENT
.SH REPO OPTIONS
.INDENT 0.0
.TP
.B \fBbaseurl\fP
\fI\%list\fP
.sp
List of URLs for the repository.
.sp
Default [].
.sp
URLs are tried in the listed order (equivalent to yum’s “failovermethod=priority” behaviour).
.UNINDENT
.INDENT 0.0
.TP
.B \fBcost\fP
\fI\%integer\fP
.sp
The relative cost of accessing this repository, defaulting to 1000. This
value is compared when the priorities of two repositories are the same. The
repository with the lowest cost is picked. It is useful to make the library
prefer on\-disk repositories to remote ones.
.UNINDENT
.INDENT 0.0
.TP
.B \fBenabled\fP
\fI\%boolean\fP
.sp
Include this repository as a package source.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBgpgkey\fP
\fI\%list\fP
.sp
URLs of a OpenPGP key files that can be used for signing metadata and packages
of this repository. 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.
.sp
Default: \fB[]\fP
.UNINDENT
.INDENT 0.0
.TP
.B \fBmetalink\fP
\fI\%string\fP
.sp
URL of a metalink for the repository.
.sp
Default: \fBNone\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBmirrorlist\fP
\fI\%string\fP
.sp
URL of a mirrorlist for the repository.
.sp
Default: \fBNone\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBname\fP
\fI\%string\fP
.sp
A human\-readable name of the repository. Defaults to the ID of the repository.
.UNINDENT
.INDENT 0.0
.TP
.B \fBpriority\fP
\fI\%integer\fP
.sp
The priority value of this repository. 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).
.sp
Default: 99
.UNINDENT
.INDENT 0.0
.TP
.B \fBtype\fP
\fI\%string\fP
.sp
Type of repository metadata. Supported values are: \fBrpm\-md\fP\&. Aliases for
\fBrpm\-md\fP: \fBrpm\fP, \fBrepomd\fP, \fBrpmmd\fP, \fByum\fP, \fBYUM\fP\&.
.sp
Default: empty.
.UNINDENT
.SH SOURCE AND DEBUGINFO REPOSITORY NAMES
.sp
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.
.sp
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.
.SH REPO VARIABLES
.sp
Right side of every repo option can be enriched by the following variables:
.sp
\fB$arch\fP
.INDENT 0.0
.INDENT 3.5
Refers to the system’s CPU architecture e.g, aarch64, i586, i686 and x86_64.
.UNINDENT
.UNINDENT
.sp
\fB$basearch\fP
.INDENT 0.0
.INDENT 3.5
Refers to the base architecture of the system. For example, i686 and i586 machines
both have a base architecture of i386, and AMD64 and Intel64 machines have a base architecture of x86_64.
.UNINDENT
.UNINDENT
.sp
\fB$releasever\fP
.INDENT 0.0
.INDENT 3.5
Refers to the release version of operating system which DNF5 derives from information available in RPMDB.
.UNINDENT
.UNINDENT
.sp
In addition to these hard coded variables, user\-defined ones can also be used.
They can be defined either via \fI\%variable files\fP, or by using special environmental variables.
The names of these variables must be prefixed with DNF_VAR_ and they can only consist of alphanumeric characters
and underscores:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ DNF_VAR_MY_VARIABLE=value
.EE
.UNINDENT
.UNINDENT
.sp
To use such variable in your repository configuration remove the prefix. E.g.:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[myrepo]
baseurl=https://example.site/pub/fedora/$MY_VARIABLE/releases/$releasever
.EE
.UNINDENT
.UNINDENT
.sp
Note that it is not possible to override the \fBarch\fP and \fBbasearch\fP variables using either variable files or
environmental variables.
.sp
Although users are encouraged to use named variables, the numbered environmental variables
\fBDNF0\fP \- \fBDNF9\fP are still supported:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ DNF1=value

[myrepo]
baseurl=https://example.site/pub/fedora/$DNF1/releases/$releasever
.EE
.UNINDENT
.UNINDENT
.SH OPTIONS FOR BOTH [MAIN] AND REPO
.sp
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, which repositories can then override in their
configuration.
.INDENT 0.0
.TP
.B \fBbandwidth\fP
\fI\%storage size\fP
.sp
Total bandwidth available for downloading.
Meaningful when used with the \fI\%throttle option\fP\&.
.sp
Default: \fB0\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBbuild_cache\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will save libsolv cache generated from downloaded metadata
to cachedir. These solv files are loaded during subsequent runs which
significantly speeds up DNF5.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcountme\fP
\fI\%boolean\fP
.sp
When enabled, one (and only one) HTTP GET request for the metalink file
will be selected at random every week to carry a special URL flag.
.sp
This flag allows the repository provider to estimate the number of systems
consuming the repository, by counting such requests over a week\(aqs time.
This method is more accurate than just counting unique IP addresses (which
is subject to both overcounting and undercounting due to short DHCP leases
and NAT, respectively).
.sp
This is \fInot\fP an out\-of\-band HTTP request made for this purpose alone.
Only requests initiated by DNF during normal operation, such as to check
for metadata updates, can get this flag.
.sp
The flag is a simple \(dqcountme=N\(dq parameter appended to the metalink URL
where N is an integer representing the age \(dqbucket\(dq this system belongs to.
Four buckets are defined, based on how many full weeks have passed since
the installation of a system:
.TS
box center;
l|l.
T{
bucket
T}	T{
system age
T}
_
T{
1
T}	T{
first week
T}
_
T{
2
T}	T{
first month (2 \- 4 weeks)
T}
_
T{
3
T}	T{
first 6 months (5 \- 24 weeks)
T}
_
T{
4
T}	T{
more than 6 months (> 24 weeks)
T}
.TE
.sp
This number is meant to help distinguish short\-lived (throwaway) machines
from long\-term installs and get a better picture of how systems are used
over time.
.sp
To determine a system\(aqs installation time (\(dqepoch\(dq), the \fBmachine\-id(5)\fP
file\(aqs modification time is used as the single source of truth. This file
is semantically tied to the system\(aqs lifetime as it\(aqs typically populated
at installation time or during the first boot by an installer tool or init
system (such as \fBsystemd(1)\fP), respectively, and remains unchanged.
.sp
If the file is empty or missing (such as in containers), the time of the
very first request made using the expanded metalink URL (i.e. with any
repository variables such as \fB$releasever\fP substituted) that carried the
flag is declared as the epoch.
.sp
If no metalink URL is defined for this repository but a mirrorlist URL is,
the latter is used for this purpose instead.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBdeltarpm\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will save bandwidth by downloading much smaller delta RPM
files, rebuilding them to RPM locally. However, this is quite CPU and I/O
intensive.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBdeltarpm_percentage\fP
\fI\%integer\fP
.sp
When the relative size of delta vs pkg is larger than this, delta is not used.
(Deltas must be at least 25% smaller than the pkg).
Use \fB0\fP to turn off delta rpm processing. Local repositories (with
\fI\%file://\fP baseurl) have delta rpms turned off by default.
.sp
Default: \fB75\fP
.UNINDENT
.INDENT 0.0
.TP
.B \fBdisable_excludes\fP
\fI\%list\fP
.sp
Used to disable packages filtering. It can include a list of repository IDs (globs allowed) for which repository\-specific 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.
.UNINDENT
.INDENT 0.0
.TP
.B \fBenablegroups\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will allow the use of package groups.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBexcludepkgs\fP
\fI\%list\fP
.sp
Exclude packages of this repository, specified by a name or a glob and
separated by a comma, from all operations.
.sp
Can be disabled using \fBdisable_excludes\fP config option.
.sp
Default: \fB[]\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBfastestmirror\fP
\fI\%boolean\fP
.sp
If enabled, TCP socket latency is used to find the closest available mirror.
A mirror is then selected at random with less than twice the lowest latency for load balancing purposes.
This overrides the order provided by the mirrorlist/metalink file itself,
and does not take into consideration mirrorlist parameters such as mirror bandwidth nor preferred mirrors for client IP addresses.
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBpkg_gpgcheck\fP
\fI\%boolean\fP
.sp
Whether to perform OpenPGP signature check on packages found in this repository.
.sp
The default is False.
.sp
Doesn\(aqt apply for packages passed directly as arguments, as they are not in any repository,
see \fI\%localpkg_gpgcheck\fP\&.
.sp
Due to compatibility \fIgpgcheck\fP option is supported as well but \fIpkg_gpgcheck\fP is preferred.
.UNINDENT
.INDENT 0.0
.TP
.B \fBincludepkgs\fP
\fI\%list\fP
.sp
Include packages of this repository, specified by a name or a glob and separated by a comma, in all operations.
.sp
Inverse of \fI\%excludepkgs\fP, DNF5 will exclude any package in the repository
that doesn\(aqt match this list.
.sp
This works in conjunction with \fI\%excludepkgs\fP and doesn\(aqt override it,
so if you \(aqexcludepkgs=*.i386\(aq and \(aqincludepkgs=python*\(aq then only packages starting with python
that do not have an i386 arch will be seen by DNF5 in this repo.
.sp
Can be disabled using \fBdisable_excludes\fP config option.
.sp
Default: \fB[]\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBip_resolve\fP
\fI\%ip address\fP
.sp
Determines how DNF5 resolves host names. Set this to \fB4\fP, \fBIPv4\fP, \fB6\fP, \fBIPv6\fP
to resolve to IPv4 or IPv6 addresses only.
.sp
Default: \fBwhatever\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBlocalpkg_gpgcheck\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will perform a OpenPGP signature check on local packages (packages in a file, not in a repository).
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBmax_parallel_downloads\fP
\fI\%integer\fP
.sp
Maximum number of simultaneous package downloads. Max is \fB20\fP\&.
.sp
Default: \fB3\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBmetadata_expire\fP
\fI\%time in seconds\fP
.sp
The period after which the remote repository is checked for metadata update and in the positive
case the local metadata cache is updated.
It can be \fB\-1\fP or \fBnever\fP to make the repo never considered expired.
.sp
Expire of metadata can be also triggered by change of timestamp of configuration files
(\fBdnf.conf\fP, \fB<repo>.repo\fP).
.sp
See also \fI\%check_config_file_age\fP\&.
.sp
Default: \fB60 * 60 * 48\fP, 48 hours.
.UNINDENT
.INDENT 0.0
.TP
.B \fBminrate\fP
\fI\%storage size\fP
.sp
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
\fI\%timeout option\fP seconds, DNF5 aborts the connection.
.sp
Default: \fB1000\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBpassword\fP
\fI\%string\fP
.sp
The password used to connect to a repository with basic HTTP authentication.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy\fP
\fI\%string\fP
.sp
URL of a proxy server to connect through.
.sp
Set to an empty string in the repository configuration to disable proxy
setting inherited from the main section. The expected format of this option is
\fB<scheme>://<ip\-or\-hostname>[:port]\fP\&.
(For backward compatibility, \(aq_none_\(aq can be used instead of the empty string.)
.sp
Default: empty.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
The curl environment variables (such as \fBhttp_proxy\fP) are effective if this option is unset
(or \(aq_none_\(aq is set in the repository configuration). See the \fBcurl\fP man page for details.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy_username\fP
\fI\%string\fP
.sp
The username to use for connecting to the proxy server.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy_password\fP
\fI\%string\fP
.sp
The password to use for connecting to the proxy server.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy_auth_method\fP
\fI\%string\fP
.sp
The authentication method used by the proxy server. Valid values are
.TS
box center;
l|l.
T{
method
T}	T{
meaning
T}
_
T{
\fBbasic\fP
T}	T{
HTTP Basic authentication
T}
_
T{
\fBdigest\fP
T}	T{
HTTP Digest authentication
T}
_
T{
\fBnegotiate\fP
T}	T{
HTTP Negotiate (SPNEGO) authentication
T}
_
T{
\fBntlm\fP
T}	T{
HTTP NTLM authentication
T}
_
T{
\fBdigest_ie\fP
T}	T{
HTTP Digest authentication with an IE flavor
T}
_
T{
\fBntlm_wb\fP
T}	T{
NTLM delegating to winbind helper
T}
_
T{
\fBnone\fP
T}	T{
None auth method
T}
_
T{
\fBany\fP
T}	T{
All suitable methods
T}
.TE
.sp
Default: \fBany\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy_sslcacert\fP
\fI\%string\fP
.sp
Path to the file containing the certificate authorities to verify proxy SSL certificates.
.sp
Default: empty, uses system default.
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy_sslclientcert\fP
\fI\%string\fP
.sp
Path to the SSL client certificate used to connect to proxy server.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy_sslclientkey\fP
\fI\%string\fP
.sp
Path to the SSL client key used to connect to proxy server.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBproxy_sslverify\fP
\fI\%boolean\fP
.sp
If enabled, proxy SSL certificates are verified. If the client can not be authenticated, connecting fails and the
repository is not used any further. If \fBFalse\fP, SSL connections can be used, but certificates are not verified.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBrepo_gpgcheck\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will perform OpenPGP signature check on this repository\(aqs metadata.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
OpenPGP keys for this check are stored separately from OpenPGP keys used in package signature
verification. Furthermore, they are also stored separately for each repository.
.sp
This means that DNF5 may ask to import the same key multiple times. For example, when a key was
already imported for package signature verification and this option is turned on, it may be needed
to import it again for the repository.
.UNINDENT
.UNINDENT
.sp
Default: \fBFalse\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBretries\fP
\fI\%integer\fP
.sp
Set the number of total retries for downloading packages.
The number is cumulative, so e.g. for \fBretries=10\fP, DNF5 will fail after any package
download fails for eleventh time.
.sp
Setting this to \fB0\fP makes DNF5 try forever.
.sp
Default: \fB10\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBskip_if_unavailable\fP
\fI\%boolean\fP
.sp
If enabled, DNF5 will continue running and disable the repository that couldn\(aqt be synchronized
for any reason. This option doesn\(aqt affect skipping of unavailable packages after dependency
resolution. To check inaccessibility of repository use it in combination with
refresh command line option\&.
.sp
Default: \fBFalse\fP\&.
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
this option in particular can be set in your configuration file
by your distribution\&.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBsslcacert\fP
\fI\%string\fP
.sp
Path to the file containing the certificate authorities to verify SSL certificates.
.sp
Default: empty, uses system default.
.UNINDENT
.INDENT 0.0
.TP
.B \fBsslclientcert\fP
\fI\%string\fP
.sp
Path to the SSL client certificate used to connect to remote sites.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBsslclientkey\fP
\fI\%string\fP
.sp
Path to the SSL client key used to connect to remote sites.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBsslverify\fP
\fI\%boolean\fP
.sp
If enabled, remote SSL certificates are verified. If the client can not be authenticated,
connecting fails and the repository is not used any further.
If disabled, SSL connections can be used, but certificates are not verified.
.sp
Default: \fBTrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBthrottle\fP
\fI\%storage size\fP
.sp
Limits the downloading speed. It might be an absolute value or a percentage, relative to the value of the
\fI\%bandwidth option\fP option. \fB0\fP means no throttling.
.sp
Default: \fB0\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBtimeout\fP
\fI\%time in seconds\fP
.sp
Number of seconds to wait for a connection before timing out. Used in combination with
\fI\%minrate option\fP option.
.sp
Default: \fB30\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBusername\fP
\fI\%string\fP
.sp
The username to use for connecting to repo with basic HTTP authentication.
.sp
Default: empty.
.UNINDENT
.INDENT 0.0
.TP
.B \fBuser_agent\fP
\fI\%string\fP
.sp
The User\-Agent string to include in HTTP requests sent by DNF5.
.sp
Default:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)
.EE
.UNINDENT
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 7.0
.INDENT 3.5
\fBNAME\fP, \fBVERSION_ID\fP and \fBVARIANT_ID\fP are OS identifiers read from the
\fBos\-release(5)\fP file, and \fBOS\fP and \fBBASEARCH\fP are the canonical OS
name and base architecture, respectively.
Example:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
libdnf (Fedora 39; server; Linux.x86_64)
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH TYPES OF OPTIONS
.INDENT 0.0
.TP
.B \fBboolean\fP
Data type with only two possible values.
.sp
One of following options can be used: \fB1\fP, \fB0\fP, \fBTrue\fP, \fBFalse\fP, \fByes\fP, \fBno\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBcolor\fP
String describing color and modifiers separated with a comma, for example \fBred,bold\fP\&.
.INDENT 7.0
.IP \(bu 2
Colors: \fBblack\fP, \fBblue\fP, \fBcyan\fP, \fBgreen\fP, \fBmagenta\fP, \fBred\fP, \fBwhite\fP, \fByellow\fP\&.
.IP \(bu 2
Modifiers: \fBbold\fP, \fBblink\fP, \fBdim\fP, \fBnormal\fP, \fBreverse\fP, \fBunderline\fP\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBinteger\fP
Whole number that can be written without a fractional component.
.UNINDENT
.INDENT 0.0
.TP
.B \fBip address type\fP
String describing ip address types.
.sp
One of the following options can be used: \fB4\fP, \fBIPv4\fP, \fB6\fP, \fBIPv6\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBlist\fP
String representing one or more strings separated by space or comma characters.
.UNINDENT
.INDENT 0.0
.TP
.B \fBstorage size\fP
String representing storage sizes formed by an integer and a unit.
.sp
Valid units are \fBk\fP, \fBM\fP, \fBG\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \fBstring\fP
It is a sequence of symbols or digits without any whitespace character.
.UNINDENT
.INDENT 0.0
.TP
.B \fBtime in seconds\fP
String representing time units in seconds. Can be set to \fB\-1\fP or \fBnever\fP\&.
.UNINDENT
.SH DROP-IN CONFIGURATION DIRECTORIES
.sp
\fIDNF5\fP loads configuration options that are defined in the \fI\%main
configuration file\fP, \fI\%user configuration
files\fP and \fI\%distribution configuration
files\fP\&.
.sp
The configuration files are processed following this order:
.INDENT 0.0
.IP 1. 3
Configuration files are alphabetically sorted in a list of names from the
distribution configuration directory\&. If
a file with the same name is present in both directories, only the file from
the user configuration directory is added to the list. The
distribution file is then masked by the user file.
.IP 2. 3
Options are retrieved in order from the list The configuration from the next
file overrides the previous one. The last option wins.
.UNINDENT
.SS Example of configuration files
.sp
User configuration files:
.INDENT 0.0
.IP \(bu 2
/etc/dnf/dnf.conf
.IP \(bu 2
/etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
.IP \(bu 2
/etc/dnf/libdnf5.conf.d/60\-something.conf
.IP \(bu 2
/etc/dnf/libdnf5.conf.d/80\-user\-settings.conf
.UNINDENT
.sp
Distribution configuration files:
.INDENT 0.0
.IP \(bu 2
/usr/share/dnf5/libdnf.conf.d/50\-something.conf
.IP \(bu 2
/usr/share/dnf5/libdnf.conf.d/60\-something.conf
.IP \(bu 2
/usr/share/dnf5/libdnf.conf.d/90\-something.conf
.UNINDENT
.sp
Resulting file loading order by default
(/usr/share/dnf5/libdnf.conf.d/60\-something.conf is skipped, masked by
the user file /etc/dnf/libdnf5.conf.d/60\-something.conf):
.INDENT 0.0
.IP 1. 3
/etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
.IP 2. 3
/usr/share/dnf5/libdnf.conf.d/50\-something.conf
.IP 3. 3
/etc/dnf/libdnf5.conf.d/60\-something.conf
.IP 4. 3
/etc/dnf/libdnf5.conf.d/80\-user\-settings.conf
.IP 5. 3
/usr/share/dnf5/libdnf.conf.d/90\-something.conf
.IP 6. 3
/etc/dnf/dnf.conf
.UNINDENT
.SS Files and directories
.INDENT 0.0
.TP
.B \fBUser Configuration Directory\fP
/etc/dnf/libdnf5.conf.d/
.UNINDENT
.INDENT 0.0
.TP
.B \fBUser Configuration Files\fP
/etc/dnf/libdnf5.conf.d/20\-user\-settings.conf
.UNINDENT
.INDENT 0.0
.TP
.B \fBDistribution Configuration Directory\fP
/usr/share/dnf5/libdnf.conf.d/
.UNINDENT
.INDENT 0.0
.TP
.B \fBDistribution Configuration Files\fP
/usr/share/dnf5/libdnf.conf.d/50\-something.conf
.UNINDENT
.SH DROP-IN REPO DIRECTORIES
.sp
After the repository configurations are loaded other repo configurations can be overloaded from the directories
\fI\%user repos override directory\fP
and \fI\%distribution repos override directory\fP\&.
.sp
The format of the files inside the directories is the same as the format of the repository configuration files.
The options in the overridden files can modify existing repos but cannot create new repositories.
.sp
Override files support globs in the repository ID in order to support bulk modifications of repository parameters.
.sp
The repository overrides are processed following this order:
.INDENT 0.0
.IP 1. 3
Files from \fB/usr/share/dnf5/repos.override.d/\fP and \fB/etc/dnf5/repos.override.d/\fP are loaded in an alphabetically
sorted list. In case files have the same name, the file from \fB/etc/dnf5/repos.override.d/\fP is used.
This implies the list has only unique filenames. This also implies that the repository configuration files can be
simply masked by creating a file with the same name in the \fB/etc\fP override directory.
.IP 2. 3
The options from the files are applied in the order they are loaded. The last option wins.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
See also the documentation for \fI\%Config\-manager Command\fP to see where the overrides are used.
.UNINDENT
.UNINDENT
.SS Example configuration
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Enable \(gaskip_if_unavailable\(ga for all repositories
[*]
skip_if_unavailable = true

# And then disable \(gaskip_if_unavailable\(ga for repositories with id prefix \(dqfedora\(dq
[fedora*]
skip_if_unavailable = false
.EE
.UNINDENT
.UNINDENT
.SS Example of configuration files
.sp
This example shows the order in which override files are processed.
.sp
Files with user repos overrides:
.INDENT 0.0
.IP \(bu 2
/etc/dnf/repos.overide.d/20\-user\-overrides.repo
.IP \(bu 2
/etc/dnf/repos.overide.d/60\-something2.repo
.IP \(bu 2
/etc/dnf/repos.overide.d/80\-user\-overrides.repo
.IP \(bu 2
/etc/dnf/repos.overide.d/99\-config\-manager.repo
.UNINDENT
.sp
Files with distribution repos overrides:
.INDENT 0.0
.IP \(bu 2
/usr/share/dnf5/repos.overide.d/50\-something2.repo
.IP \(bu 2
/usr/share/dnf5/repos.overide.d/60\-something2.repo
.IP \(bu 2
/usr/share/dnf5/repos.overide.d/90\-something2.repo
.UNINDENT
.sp
Resulting file processing order:
.INDENT 0.0
.IP 1. 3
/etc/dnf/repos.overide.d/20\-user\-overrides.repo
.IP 2. 3
/usr/share/dnf5/repos.overide.d/50\-something2.repo
.IP 3. 3
/etc/dnf/repos.overide.d/60\-something2.repo
.IP 4. 3
/etc/dnf/repos.overide.d/80\-user\-overrides.repo
.IP 5. 3
/usr/share/dnf5/repos.overide.d/90\-something2.repo
.IP 6. 3
/etc/dnf/repos.overide.d/99\-config\-manager.repo
.UNINDENT
.SS Files and directories
.INDENT 0.0
.TP
.B \fBUser Repos Override Directory\fP
/etc/dnf/repos.override.d/
.UNINDENT
.INDENT 0.0
.TP
.B \fBUser Repos Override Files\fP
/etc/dnf/repos.override.d/20\-user\-overrides.repo
.UNINDENT
.INDENT 0.0
.TP
.B \fBDistribution Repos Override Directory\fP
/usr/share/dnf5/repos.override.d/
.UNINDENT
.INDENT 0.0
.TP
.B \fBDistribution Repos Override Files\fP
/usr/share/dnf5/repos.override.d/50\-something2.repo
.UNINDENT
.SH FILES
.INDENT 0.0
.TP
.B \fBMain Configuration File\fP
/etc/dnf/dnf.conf
.UNINDENT
.INDENT 0.0
.TP
.B \fBCache Files\fP
/var/cache/libdnf5
.UNINDENT
.INDENT 0.0
.TP
.B \fBRepository Files\fP
/etc/yum.repos.d/
.UNINDENT
.INDENT 0.0
.TP
.B \fBVariables\fP
Any property named file in \fB/etc/dnf/vars\fP is turned into a variable named after the filename
(or overrides any of the above variables but those set from commandline).
Filenames may contain only alphanumeric characters and underscores and be in lowercase.
Variables are also read from \fB/etc/yum/vars\fP for YUM compatibility reasons.
.UNINDENT
.SH DIRECTORIES
.SS Repository Directories
.sp
Directories are listed in the order in which they are processed.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
Unlike overrides that modify an existing repository configuration,
the configuration in these directories defines new repositories.
It is not possible to define repositories with the same ID.
If multiple repositories with the same ID are defined only the first configuration
will be loaded. Loading the next one will log an error.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBYUM Repositories Directory\fP
/etc/yum.repos.d/
.UNINDENT
.INDENT 0.0
.TP
.B \fBDistribution Repositories Directory in /etc\fP
/etc/distro.repos.d/
.TP
.B \fBDistribution Repositories Directory in /usr\fP
/usr/share/dnf5/repos.d/
.UNINDENT
.SS Variables Directories
.INDENT 0.0
.TP
.B \fBVariables Directory\fP
/etc/dnf/vars/
.UNINDENT
.INDENT 0.0
.TP
.B \fBDistribution Variables Directory\fP
/usr/share/dnf5/vars.d/
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.IP \(bu 2
\fBdnf5(8)\fP, \fI\%DNF5 Command Reference\fP
.IP \(bu 2
\fBdnf5.conf\-todo(5)\fP, \fI\%Options that are documented/implemented in DNF but not in DNF5\fP
.IP \(bu 2
\fBdnf5.conf\-deprecated(5)\fP, \fI\%Config Options that are deprecated in DNF5\fP
.UNINDENT
.SH AUTHOR
See AUTHORS.md in dnf5 source distribution.
.SH COPYRIGHT
Contributors to the dnf5 project.
.\" Generated by docutils manpage writer.
.