yum.conf(5) yum configuration file yum.conf(5)NAMEyum.conf - Configuration file for yum(8).
DESCRIPTION
Yum uses a configuration file at /etc/yum.conf.
Additional configuration files are also read from the directories set
by the reposdir option (default is `/etc/yum.repos.d'). See the repos‐
dir option below for further details.
PARAMETERS
There are two types of sections in the yum configuration file(s): main
and repository. Main defines all global configuration options. There
should be only one main section. The repository section(s) define the
configuration for each repository/server. There should be one or more
repository sections.
[main] OPTIONS
The [main] section must exist for yum to do anything. It consists of
the following options:
cachedir Directory where yum should store its cache and db
files. The default is `/var/cache/yum'.
persistdir Directory where yum should store information that
should persist over multiple runs. The default is
`/var/lib/yum'.
keepcache Either `1' or `0'. Determines whether or not yum keeps
the cache of headers and packages after successful installation.
Default is '1' (keep files)
reposdir A list of directories where yum should look for .repo
files which define repositories to use. Default is
`/etc/yum.repos.d'. Each file in this directory should contain
one or more repository sections as documented in [repository]
options below. These will be merged with the repositories
defined in /etc/yum.conf to form the complete set of reposito‐
ries that yum will use.
debuglevel Debug message output level. Practical range is 0-10.
Default is `2'.
errorlevel Error message output level. Practical range is 0-10.
Default is `2'.
rpmverbosity Debug scriptlet output level. 'info' is the
default, other options are: 'critical', 'emergency', 'error',
'warn' and 'debug'.
protected_packages This is a list of packages that yum should
never completely remove. They are protected via Obsoletes as
well as user/plugin removals.
The default is: yum glob:/etc/yum/protected.d/*.conf So any
packages which should be protected can do so by including a file
in /etc/yum/protected.d with their package name in it.
Also if this configuration is set to anything, then yum will
protect the package corresponding to the running version of the
kernel.
protected_multilib Either `1' or `0'. This tells yum whether or
not it should perform a check to make sure that multilib pack‐
ages are the same version. For example, if this option is off
(rpm behaviour) pkgA-1.x86_64 and pkgA-2.i386 can be installed
at the same time. However this is very rarely desired. Install
only packages, like the kernel, are exempt from this check. The
default is `1'.
logfile Full directory and file name for where yum should write
its log file.
gpgcheck Either `1' or `0'. This tells yum whether or not it
should perform a GPG signature check on packages. When this is
set in the [main] section it sets the default for all reposito‐
ries. The default is `0'.
localpkg_gpgcheck Either `1' or `0'. This tells yum whether or
not it should perform a GPG signature check on local packages
(packages in a file, not in a repositoy). The default is `0'.
repo_gpgcheck Either `1' or `0'. This tells yum whether or not
it should perform a GPG signature check on the repodata. When
this is set in the [main] section it sets the default for all
repositories. The default is `0'.
skip_broken Either `1' or `0'. Resolve depsolve problems by
removing packages that are causing problems from the transac‐
tion.
assumeyes Either `1' or `0'. Determines whether or not yum
prompts for confirmation of critical actions. Default is `0' (do
prompt).
Command-line option: -y --assumeyes
assumeno Either `1' or `0'. If yum would prompt for confirmation
of critical actions, assume the user chose no. This is basically
the same as doing "echo | yum ..." but is a bit more usable.
This option overrides assumeyes, but is still subject to
alwaysprompt. Default is `0' (do prompt).
Command-line option: --assumeno
alwaysprompt Either `1' or `0'. Without this option, yum will
not prompt for confirmation when the list of packages to be
installed exactly matches those given on the command line.
Unless assumeyes is enabled, it will still prompt when addi‐
tional packages need to be installed to fulfill dependencies.
Note that older versions of yum would also always prompt for
package removal, and that is no longer true. Default is `1'.
tolerant Either `1' or `0'. If enabled, yum will go slower,
checking for things that shouldn't be possible making it more
tolerant of external errors. Default to `0' (not tolerant).
Command-line option: -t
exclude List of packages to exclude from all repositories, so
yum works as if that package was never in the repositories. This
should be a space separated list. This is commonly used so a
package isn't upgraded or installed accidentally, but can be
used to remove packages in any way that "yum list" will show
packages. Shell globs using wildcards (eg. * and ?) are
allowed.
Can be disabled using --disableexcludes. Command-line option:
-x
installonlypkgs List of package provides that should only ever
be installed, never updated. Kernels in particular fall into
this category. Defaults to kernel, kernel-bigmem, kernel-enter‐
prise, kernel-smp, kernel-debug, kernel-unsupported, kernel-
source, kernel-devel, kernel-PAE, kernel-PAE-debug.
Note that because these are provides, and not just package
names, kernel-devel will also apply to kernel-debug-devel, etc.
Note that "kernel-modules" is not in this list, in RHEL-6, and
so anything providing that is updated like any other package.
installonly_limit Number of packages listed in installonlypkgs
to keep installed at the same time. Setting to 0 disables this
feature. Default is '3'. Note that this functionality used to be
in the "installonlyn" plugin, where this option was altered via
tokeep. Note that as of version 3.2.24, yum will now look in
the yumdb for a installonly attribute on installed packages. If
that attribute is "keep", then they will never be removed.
kernelpkgnames List of package names that are kernels. This is
really only here for the updating of kernel packages and should
be removed out in the yum 2.1 series.
showdupesfromrepos Either `0' or `1'. Set to `1' if you wish to
show any duplicate packages from any repository, from package
listings like the info or list commands. Set to `0' if you want
only to see the newest packages from any repository. Default is
`0'.
obsoletes This option only has affect during an update. It
enables yum's obsoletes processing logic. Useful when doing dis‐
tribution level upgrades. See also the yum upgrade command docu‐
mentation for more details (yum(8)). Default is `true'.
Command-line option: --obsoletes
remove_leaf_only Either `0' or `1'. Used to determine yum's be‐
haviour when a package is removed. If remove_leaf_only is `0'
(default) then packages, and their deps, will be removed. If
remove_leaf_only is `1' then only those packages that aren't
required by another package will be removed.
repopkgsremove_leaf_only Either `0' or `1'. Used to determine
yum's behaviour when the repo-pkg remove command is run. If
repopkgremove_leaf_only is `0' (default) then all packages in
the repo. will be removed. If repopkgremove_leaf_only is `1'
then only those packages in the repo. that aren't required by
another package will be removed. Note that this option does not
override remove_leaf_only, so enabling that option means this
has almost no affect.
overwrite_groups Either `0' or `1'. Used to determine yum's be‐
haviour if two or more repositories offer the package groups
with the same name. If overwrite_groups is `1' then the group
packages of the last matching repository will be used. If over‐
write_groups is `0' then the groups from all matching reposito‐
ries will be merged together as one large group. Note that this
option does not override remove_leaf_only, so enabling that
option means this has almost no affect.
groupremove_leaf_only Either `0' or `1'. Used to determine yum's
behaviour when the groupremove command is run. If groupre‐
move_leaf_only is `0' (default) then all packages in the group
will be removed. If groupremove_leaf_only is `1' then only
those packages in the group that aren't required by another
package will be removed.
enable_group_conditionals Either `0' or `1'. Determines whether
yum will allow the use of conditionals packages. Default is `1'
(package conditionals are allowed).
group_package_types List of the following: optional, default,
mandatory. Tells yum which type of packages in groups will be
installed when 'groupinstall' is called. Default is: default,
mandatory
group_command List of the following: simple, compat, objects.
Tells yum what to do for group install/upgrade/remove commands.
Simple acts like you did yum group cmd $(repoquery --group
--list group), so it is vrery easy to reason about what will
happen. Alas. this is often not what people want to happen.
Compat. works much like simple, except that when you run "group
upgrade" it actually runs "group install" (this means that you
get any new packages added to the group, but you also get pack‐
ages added that were there before and you didn't want).
Objects makes groups act like a real object, separate from the
packages they contain. Yum keeps track of the groups you have
installed, so "group upgrade" will install new packages for the
group but not install old ones. It also knows about group mem‐
bers that are installed but weren't installed as part of the
group, and won't remove those on "group remove". Running "yum
upgrade" will also run "yum group upgrade" (thus. adding new
packages for all groups).
Default is: objects
upgrade_group_objects_upgrade Either `0' or `1'. Set this to `0'
to disable the automatic running of "group upgrade" when running
the "upgrade" command, and group_command is set to "objects".
Default is `1' (perform the operation).
autocheck_running_kernel Either `0' or `1'. Set this to `0' to
disable the automatic checking of the running kernel against
updateinfo ("yum updateinfo check-running-kernel"), in the
"check-update" and "updateinfo summary" commands. Default is
`1' (perform the check).
installroot Specifies an alternative installroot, relative to
which all packages will be installed.
Command-line option: --installroot
config_file_path Specifies the path to main the configuration
file. Default is /etc/yum/yum.conf.
check_config_file_age Either `0' or `1'. Specifies whether yum
should auto metadata expire repos. that are older than any of
the configuration files that led to them (usually the yum.conf
file and the foo.repo file). Default is `1' (perform the
check).
distroverpkg The package used by yum to determine the "version"
of the distribution, this sets $releasever for use in config.
files. This can be any installed package. Default is `system-
release(releasever)', `redhat-release'. Yum will now look at the
version provided by the provide, and if that is non-empty then
will use the full V(-R), otherwise it uses the version of the
package.
You can see what provides this manually by using: "yum whatpro‐
vides 'system-release(releasever)' redhat-release" and you can
see what $releasever is most easily by using: "yum version".
diskspacecheck Either `0' or `1'. Set this to `0' to disable the
checking for sufficient diskspace and inodes before a RPM trans‐
action is run. Default is `1' (perform the check).
tsflags Comma or space separated list of transaction flags to
pass to the rpm transaction set. These include 'noscripts',
'notriggers', 'nodocs', 'test', 'justdb' and 'nocontexts'.
'repackage' is also available but that does nothing with newer
rpm versions. You can set all/any of them. However, if you
don't know what these do in the context of an rpm transaction
set you're best leaving it alone. Default is an empty list.
Also see the "yum fs" command, for excluding docs.
override_install_langs This is a way to override rpm's
_install_langs macro. without having to change it within rpm's
macro file. Default is nothing (so does nothing). Also see the
"yum fs" command.
recent Number of days back to look for `recent' packages added
to a repository. Used by the list recent command. Default is
`7'.
retries Set the number of times any attempt to retrieve a file
should retry before returning an error. Setting this to `0'
makes yum try forever. Default is `10'.
keepalive Either `0' or `1'. Set whether HTTP keepalive should
be used for HTTP/1.1 servers that support it. This can improve
transfer speeds by using one connection when downloading multi‐
ple files from a repository. Default is `1'.
timeout Number of seconds to wait for a connection before timing
out. Defaults to 30 seconds. This may be too short of a time for
extremely overloaded sites.
http_caching Determines how upstream HTTP caches are instructed
to handle any HTTP downloads that Yum does. This option can take
the following values:
`all' means that all HTTP downloads should be cached.
`packages' means that only RPM package downloads should be
cached (but not repository metadata downloads).
`none' means that no HTTP downloads should be cached.
The default is `all'. This is recommended unless you are experi‐
encing caching related issues. Try to at least use `packages' to
minimize load on repository servers.
throttle Enable bandwidth throttling for downloads. This option
can be expressed as a absolute data rate in bytes/sec. An SI
prefix (k, M or G) may be appended to the bandwidth value (eg.
`5.5k' is 5.5 kilobytes/sec, `2M' is 2 Megabytes/sec).
Alternatively, this option can specify the percentage of total
bandwidth to use (eg. `60%'). In this case the bandwidth option
should be used to specify the maximum available bandwidth.
Set to `0' to disable bandwidth throttling. This is the default.
Note that when multiple downloads run simultaneously the total
bandwidth might exceed the throttle limit. You may want to also
set max_connections=1 or scale your throttle option down accord‐
ingly.
minrate This sets the low speed threshold in bytes per second.
If the server is sending data slower than this for at least
`timeout' seconds, Yum aborts the connection. The default is
`1000'.
bandwidth Use to specify the maximum available network bandwidth
in bytes/second. Used with the throttle option (above). If
throttle is a percentage and bandwidth is `0' then bandwidth
throttling will be disabled. If throttle is expressed as a data
rate (bytes/sec) then this option is ignored. Default is `0' (no
bandwidth throttling).
ip_resolve Determines how yum resolves host names.
`4' or `IPv4': resolve to IPv4 addresses only.
`6' or `IPv6': resolve to IPv6 addresses only.
max_connections
The maximum number of simultaneous connections. This overrides
the urlgrabber default of 5 connections. Note that there are
also implicit per-mirror limits and the downloader honors these
too.
deltarpm
When non-zero, delta-RPM files are used if available. The value
specifies the maximum number of "applydeltarpm" processes Yum
will spawn, if the value is negative then yum works out how many
cores you have and multiplies that by the value (cores=2,
deltarpm=-2; 4 processes). (2 by default).
Note that the "applydeltarpm" process uses a significant amount
of disk IO, so running too many instances can significantly slow
down all disk IO including the downloads that yum is doing
(thus. a too high value can make everything slower).
deltarpm_percentage When the relative size of delta vs pkg is
larger than this, delta is not used. Default value is 75
(Deltas must be at least 25% smaller than the pkg). Use `0' to
turn off delta rpm processing. Local repositories (with file://
baseurl) have delta rpms turned off by default.
deltarpm_metadata_percentage When the relative size of deltarpm
metadata vs pkgs is larger than this, deltarpm metadata is not
downloaded from the repo. Default value is 100 (Deltarpm meta‐
data must be smaller than the packages from the repo). Note that
you can give values over 100, so 200 means that the metadata is
required to be half the size of the packages. Use `0' to turn
off this check, and always download metadata.
sslcacert Path to the directory containing the databases of the
certificate authorities yum should use to verify SSL certifi‐
cates. Defaults to none - uses system default
sslverify Boolean - should yum verify SSL certificates/hosts at
all. Defaults to True.
Note that the plugin yum-rhn-plugin will force this value to
true, and may alter other ssl settings (like hostname checking),
even if it the machine is not registered.
sslclientcert Path to the SSL client certificate yum should use
to connect to repos/remote sites Defaults to none.
Note that if you are using curl compiled against NSS (default in
Fedora/RHEL), curl treats sslclientcert values with the same
basename as _identical_. This version of yum will check that
this isn't true and output an error when the repositories "foo"
and "bar" violate this, like so:
sslclientcert basename shared between foo and bar
sslclientkey Path to the SSL client key yum should use to con‐
nect to repos/remote sites Defaults to none.
ssl_check_cert_permissions Boolean - Whether yum should check
the permissions on the paths for the certificates on the reposi‐
tory (both remote and local). If we can't read any of the files
then yum will force skip_if_unavailable to be true. This is
most useful for non-root processes which use yum on repos. that
have client cert files which are readable only by root.
Defaults to True.
history_record Boolean - should yum record history entries for
transactions. This takes some disk space, and some extra time in
the transactions. But it allows how to know a lot of information
about what has happened before, and display it to the user with
the history info/list/summary commands. yum also provides the
history undo/redo commands. Defaults to True.
Note that if history is recorded, yum uses that information to
see if any modifications to the rpmdb have been done outside of
yum. These are always bad, from yum's point of view, and so yum
will issue a warning and automatically run some of "yum check"
to try and find some of the worst problems altering the rpmdb
might have caused.
This means that turning this option off will stop yum from being
able to detect when the rpmdb has changed and thus. it will
never warn you or automatically run "yum check". The problems
will likely still be there, and yumdb etc. will still be wrong
but yum will not warn you about it.
history_record_packages This is a list of package names that
should be recorded as having helped the transaction. yum plugins
have an API to add themselves to this, so it should not normally
be necessary to add packages here. Not that this is also used
for the packages to look for in --version. Defaults to rpm, yum,
yum-metadata-parser.
history_list_view Which column of information to display in the
"yum history list" command. There are currently three options:
users, cmds (or commands), auto.
Older versions of yum acted like "users", which always outputs
the user who initiated the yum transaction. You can now specify
"commands" which will instead always output the command line of
the transaction. You can also specify "single-user-commands"
which will display the users if there are more than one, other‐
wise it will display the command line.
You can also specify "default" which currently selects "single-
user-commands".
commands List of functional commands to run if no functional
commands are specified on the command line (eg. "update foo bar
baz quux"). None of the short options (eg. -y, -e, -d) are
accepted for this option.
syslog_ident Identification (program name) for syslog messages.
syslog_facility Facility name for syslog messages, see sys‐
log(3). Default is `LOG_USER'.
syslog_device Where to log syslog messages. Can be a local
device (path) or a host:port string to use a remote syslog. If
empty or points to a nonexistent device, syslog logging is dis‐
abled. Default is `/dev/log'.
proxy URL to the proxy server that yum should use. Set this to
`libproxy' to enable proxy auto configuration via libproxy.
Defaults to direct connection.
proxy_username username to use for proxy
proxy_password password for this proxy
username username to use for basic authentication to a repo or
really any url.
password password to use with the username for basic authentica‐
tion.
plugins Either `0' or `1'. Global switch to enable or disable
yum plugins. Default is `0' (plugins disabled). See the PLUGINS
section of the yum(8) man for more information on installing yum
plugins.
pluginpath A list of directories where yum should look for plug‐
in modules. Default is `/usr/share/yum-plugins' and
`/usr/lib/yum-plugins'.
pluginconfpath A list of directories where yum should look for
plugin configuration files. Default is `/etc/yum/pluginconf.d'.
metadata_expire Time (in seconds) after which the metadata will
expire. So that if the current metadata downloaded is less than
this many seconds old then yum will not update the metadata
against the repository. If you find that yum is not downloading
information on updates as often as you would like lower the
value of this option. You can also change from the default of
using seconds to using days, hours or minutes by appending a d,
h or m respectively. The default is 6 hours, to compliment yum-
updatesd running once an hour. It's also possible to use the
word "never", meaning that the metadata will never expire. Note
that when using a metalink file the metalink must always be
newer than the metadata for the repository, due to the valida‐
tion, so this timeout also applies to the metalink file. Also
note that "never" does not override "yum clean expire-cache"
metadata_expire_filter Filter the metadata_expire time, allowing
a trade of speed for accuracy if a command doesn't require it.
Each yum command can specify that it requires a certain level of
timeliness quality from the remote repos. from "I'm about to
install/upgrade, so this better be current" to "Anything that's
available is good enough".
`never' - Nothing is filtered, always obey metadata_expire.
`read-only:past' - Commands that only care about past informa‐
tion are filtered from metadata expiring. Eg. yum history info
(if history needs to lookup anything about a previous transac‐
tion, then by definition the remote package was available in the
past).
`read-only:present' - Commands that are balanced between past
and future. This is the default. Eg. yum list yum
`read-only:future' - Commands that are likely to result in run‐
ning other commands which will require the latest metadata. Eg.
yum check-update
Note that this option does not override "yum clean expire-
cache".
mirrorlist_expire Time (in seconds) after which the mirrorlist
locally cached will expire. If the current mirrorlist is less
than this many seconds old then yum will not download another
copy of the mirrorlist, it has the same extra format as meta‐
data_expire. If you find that yum is not downloading the mir‐
rorlists as often as you would like lower the value of this
option.
mdpolicy You can select from different metadata download poli‐
cies depending on how much data you want to download with the
main repository metadata index. The advantages of downloading
more metadata with the index is that you can't get into situa‐
tions where you need to use that metadata later and the versions
available aren't compatible (or the user lacks privileges) and
that if the metadata is corrupt in any way yum will revert to
the previous metadata.
`instant' - Just download the new metadata index, this is
roughly what yum always did, however it now does some checking
on the index and reverts if it classifies it as bad.
`group:primary' - Download the primary metadata with the index.
This contains most of the package information and so is almost
always required anyway.
`group:small' - With the primary also download the updateinfo
metadata, groups, and pkgtags. This is required for yum-security
operations and it also used in the graphical clients. This file
also tends to be significantly smaller than most others. This is
the default.
`group:main' - With the primary and updateinfo download the
filelists metadata and the group metadata. The filelists data is
required for operations like "yum install /bin/bash", and also
some dependency resolutions require it. The group data is used
in some graphical clients and for group operations like "yum
grouplist Base".
`group:all' - Download all metadata listed in the index, cur‐
rently the only one not listed above is the other metadata,
which contains the changelog information which is used by yum-
changelog. This is what "yum makecache" uses.
mddownloadpolicy You can select which kinds of repodata you
would prefer yum to download:
`sqlite' - Download the .sqlite files, if available. This is
currently slightly faster, once they are downloaded. However
these files tend to be bigger, and thus. take longer to down‐
load.
`xml' - Download the .XML files, which yum will do anyway as a
fallback on the other options. These files tend to be smaller,
but they require parsing/converting locally after download and
some aditional checks are performed on them each time they are
used.
multilib_policy Can be set to 'all' or 'best'. All means install
all possible arches for any package you want to install. There‐
fore yum install foo will install foo.i386 and foo.x86_64 on
x86_64, if it is available. Best means install the best arch for
this platform, only.
bugtracker_url URL where bugs should be filed for yum. Config‐
urable for local versions or distro-specific bugtrackers.
color Whether to display colorized output automatically, depend‐
ing on the output terminal, can be changed to always (using ANSI
codes) or never. Default is `auto'. Possible values are: auto,
never, always. Command-line option: --color
color_list_installed_older The colorization/highlighting for
packages in list/info installed which are older than the latest
available package with the same name and arch. Default is
`bold'. Possible values are a comma separated list containing:
bold, blink, dim, reverse, underline, fg:black, fg:red,
fg:green, fg:yellow, fg:blue, fg:magenta, fg:cyan, fg:white,
bg:black, bg:red, bg:green, bg:yellow, bg:blue, bg:magenta,
bg:cyan, bg:white.
color_list_installed_newer The colorization/highlighting for
packages in list/info installed which are newer than the latest
available package with the same name and arch. Default is
`bold,yellow'. See color_list_installed_older for possible val‐
ues.
color_list_installed_reinstall The colorization/highlighting for
packages in list/info installed which is the same version as the
latest available package with the same name and arch. Default
is `normal'. See color_list_installed_older for possible val‐
ues.
color_list_installed_running_kernel The colorization/highlight‐
ing for kernel packages in list/info installed which is the same
version as the running kernel. Default is `bold,underline. See
color_list_installed_older for possible values.
color_list_installed_extra The colorization/highlighting for
packages in list/info installed which has no available package
with the same name and arch. Default is `bold,red'. See
color_list_installed_older for possible values.
color_list_available_upgrade The colorization/highlighting for
packages in list/info available which is an upgrade for the lat‐
est installed package with the same name and arch. Default is
`bold,blue'. See color_list_installed_older for possible val‐
ues.
color_list_available_downgrade The colorization/highlighting for
packages in list/info available which is a downgrade for the
latest installed package with the same name and arch. Default
is `dim,cyan'. See color_list_installed_older for possible val‐
ues.
color_list_available_install The colorization/highlighting for
packages in list/info available which has no installed package
with the same name and arch. Default is `normal'. See
color_list_installed_older for possible values.
color_list_available_reinstall The colorization/highlighting for
packages in list/info available which is the same version as the
installed package with the same name and arch. Default is
`bold,underline,green. See color_list_installed_older for pos‐
sible values.
color_list_available_running_kernel The colorization/highlight‐
ing for kernel packages in list/info available which is the same
version as the running kernel. Default is `bold,underline. See
color_list_installed_older for possible values.
color_search_match The colorization/highlighting for text
matches in search. Default is `bold'. See
color_list_installed_older for possible values.
color_update_installed The colorization/highlighting for pack‐
ages in the "updates list" which are installed. The updates list
is what is printed when you run "yum update", "yum list
updates", "yum list obsoletes" and "yum check-update". Default
is `normal'. See color_list_installed_older for possible val‐
ues.
color_update_local The colorization/highlighting for packages in
the "updates list" which are already downloaded. The updates
list is what is printed when you run "yum update", "yum list
updates", "yum list obsoletes" and "yum check-update". Default
is `bold'. See color_list_installed_older for possible values.
color_update_remote The colorization/highlighting for packages
in the "updates list" which need to be downloaded. The updates
list is what is printed when you run "yum update", "yum list
updates", "yum list obsoletes" and "yum check-update". Default
is `normal'. See color_list_installed_older for possible val‐
ues.
ui_repoid_vars When a repository id is displayed, append these
yum variables to the string if they are used in the baseurl/etc.
Variables are appended in the order listed (and found). Default
is 'releasever basearch'.
clean_requirements_on_remove When removing packages (by removal,
update or obsoletion) go through each package's dependencies. If
any of them are no longer required by any other package then
also mark them to be removed. Boolean (1, 0, True, False, yes,
no) Defaults to False
upgrade_requirements_on_install When installing/rein‐
stalling/upgrading packages go through each package's installed
dependencies and check for an update. Boolean (1, 0, True,
False, yes,no) Defaults to False
recheck_installed_requires When upgrading a package do we
recheck any requirements that existed in the old package. Turn‐
ing this on shouldn't do anything but slow yum depsolving down,
however using rpm --nodeps etc. can break the rpmdb and then
this will help. Boolean (1, 0, True, False, yes,no) Defaults to
False
reset_nice If set to true then yum will try to reset the nice
value to zero, before running an rpm transaction. Defaults to
True.
exit_on_lock Should the yum client exit immediately when some‐
thing else has the lock. Boolean (1, 0, True, False, yes, no)
Defaults to False
loadts_ignoremissing Should the load-ts command ignore packages
that are missing. This includes packages in the TS to be
removed, which aren't installed, and packages in the TS to be
added, which aren't available. If this is set to true, and an
rpm is missing then loadts_ignorenewrpm is automatically set to
true. Boolean (1, 0, True, False, yes, no) Defaults to False
loadts_ignorerpm Should the load-ts command ignore the rpmdb
version (yum version nogroups) or abort if there is a mismatch
between the TS file and the current machine. If this is set to
true, then loadts_ignorenewrpm is automatically set to true.
Boolean (1, 0, True, False, yes, no) Defaults to False
loadts_ignorenewrpm Should the load-ts command ignore the future
rpmdb version or abort if there is a mismatch between the TS
file and what will happen on the current machine. Note that if
loadts_ignorerpm is True, this option does nothing. Boolean (1,
0, True, False, yes, no) Defaults to False
fssnap_automatic_pre Should yum try to automatically create a
snapshot before it runs a transaction. Boolean (1, 0, True,
False, yes, no) Defaults to False
fssnap_automatic_post Should yum try to automatically create a
snapshot after it runs a transaction. Boolean (1, 0, True,
False, yes, no) Defaults to False
fssnap_automatic_keep How many old snapshots should yum keep
when trying to automatically create a new snapshot. Setting to 0
disables this feature. Default is '0'.
fssnap_automatic_percentage The size of new snaphosts, expressed
as a percentage of the old origin device. Any number between 1
and 100. Default is '100'.
fssnap_automatic_devices The origin LVM devices to use for snap‐
shots. Wildcards and negation are allowed, first match (positive
or negative) wins. Default is: !*/swap !*/lv_swap
glob:/etc/yum/fssnap.d/*.conf
depsolve_loop_limit Set the number of times any attempt to dep‐
solve before we just give up. This shouldn't be needed as yum
should always solve or fail, however it has been observed that
it can loop forever with very large system upgrades. Setting
this to `0' (or "<forever>") makes yum try forever. Default is
`100'.
[repository] OPTIONS
The repository section(s) take the following form:
Example: [repositoryid]
name=Some name for this repository
baseurl=url://path/to/repository/
repositoryid Must be a unique name for each repository, one
word.
name A human readable string describing the repository.
baseurl Must be a URL to the directory where the yum reposi‐
tory's `repodata' directory lives. Can be an http://, ftp:// or
file:// URL. You can specify multiple URLs in one baseurl state‐
ment. The best way to do this is like this:
[repositoryid]
name=Some name for this repository
baseurl=url://server1/path/to/repository/
url://server2/path/to/repository/
url://server3/path/to/repository/
If you list more than one baseurl= statement in a repository you
will find yum will ignore the earlier ones and probably act
bizarrely. Don't do this, you've been warned.
You can use HTTP basic auth by prepending "user:password@" to
the server name in the baseurl line. For example:
"baseurl=http://user:passwd@example.com/".
metalink Specifies a URL to a metalink file for the repomd.xml,
a list of mirrors for the entire repository are generated by
converting the mirrors for the repomd.xml file to a baseurl. The
metalink file also contains the latest timestamp from the data
in the repomd.xml, the length of the repomd.xml and checksum
data. This data is checked against any downloaded repomd.xml
file and all of the information from the metalink file must
match. This can be used instead of or with the baseurl option.
Substitution variables, described below, can be used with this
option. This option disables the mirrorlist option. As a spe‐
cial hack is the mirrorlist URL contains the word "metalink"
then the value of mirrorlist is copied to metalink (if metalink
is not set).
mirrorlist Specifies a URL to a file containing a list of
baseurls. This can be used instead of or with the baseurl
option. Substitution variables, described below, can be used
with this option. As a special hack is the mirrorlist URL con‐
tains the word "metalink" then the value of mirrorlist is copied
to metalink (if metalink is not set).
enabled Either `1' or `0'. This tells yum whether or not use
this repository.
keepcache Overrides the keepcache option from the [main] section
for this repository.
gpgcheck Either `1' or `0'. This tells yum whether or not it
should perform a GPG signature check on the packages gotten from
this repository.
repo_gpgcheck Either `1' or `0'. This tells yum whether or not
it should perform a GPG signature check on the repodata from
this repository.
gpgkey A URL pointing to the ASCII-armored GPG key file for the
repository. This option is used if yum needs a public key to
verify a package and the required key hasn't been imported into
the RPM database. If this option is set, yum will automatically
import the key from the specified URL. You will be prompted
before the key is installed unless the assumeyes option is set.
Multiple URLs may be specified here in the same manner as the
baseurl option (above). If a GPG key is required to install a
package from a repository, all keys specified for that reposi‐
tory will be installed.
gpgcakey A URL pointing to the ASCII-armored CA key file for the
repository. This is a normal gpg public key - but this key will
be used to validate detached signatures of all other keys. The
idea is you are asked to confirm import for this key. After that
any other gpg key needed for package or repository verification,
if it has a detached signature which matches this key will be
automatically imported without user confirmation.
exclude Same as the [main] exclude option but only for this
repository. Substitution variables, described below, are hon‐
ored here.
Can be disabled using --disableexcludes.
includepkgs Inverse of exclude, yum will exclude any package in
the repo. that doesn't match this list. This works in conjunc‐
tion with exclude and doesn't override it, so if you
exclude=*.i386 and includepkgs=python* then only packages start‐
ing with python that do not have an i386 arch. will be seen by
yum in this repo.
Substitution variables, described below, are honored here.
Can be disabled using --disableexcludes.
enablegroups Either `0' or `1'. Determines whether yum will
allow the use of package groups for this repository. Default is
`1' (package groups are allowed).
failovermethod Either `roundrobin' or `priority'.
`roundrobin' randomly selects a URL out of the list of URLs to
start with and proceeds through each of them as it encounters a
failure contacting the host.
`priority' starts from the first baseurl listed and reads
through them sequentially.
failovermethod defaults to `roundrobin' if not specified.
keepalive Either `1' or `0'. This tells yum whether or not
HTTP/1.1 keepalive should be used with this repository. See the
global option in the [main] section above for more information.
timeout Overrides the timeout option from the [main] section for
this repository.
http_caching Overrides the http_caching option from the [main]
section for this repository.
retries Overrides the retries option from the [main] section for
this repository.
throttle Overrides the throttle option from the [main] section
for this repository.
bandwidth Overrides the bandwidth option from the [main] section
for this repository.
ip_resolve Overrides the ip_resolve option from the [main] sec‐
tion for this repository.
deltarpm_percentage Overrides the deltarpm_percentage option
from the [main] section for this repository.
deltarpm_metadata_percentage Overrides the deltarpm_meta‐
data_percentage option from the [main] section for this reposi‐
tory.
sslcacert Overrides the sslcacert option from the [main] section
for this repository.
sslverify Overrides the sslverify option from the [main] section
for this repository.
sslclientcert Overrides the sslclientcert option from the [main]
section for this repository.
sslclientkey Overrides the sslclientkey option from the [main]
section for this repository.
ssl_check_cert_permissions Overrides the ssl_check_cert_permis‐
sions option from the [main] section for this repository.
metadata_expire Overrides the metadata_expire option from the
[main] section for this repository.
metadata_expire_filter Overrides the metadata_expire_filter
option from the [main] section for this repository.
mirrorlist_expire Overrides the mirrorlist_expire option from
the [main] section for this repository.
proxy URL to the proxy server for this repository. Set to
'_none_' to disable the global proxy setting for this reposi‐
tory. If this is unset it inherits it from the global setting
proxy_username username to use for proxy. If this is unset it
inherits it from the global setting
proxy_password password for this proxy. If this is unset it
inherits it from the global setting
username username to use for basic authentication to a repo or
really any url. If this is unset it inherits it from the global
setting
password password to use with the username for basic authentica‐
tion. If this is unset it inherits it from the global setting
cost relative cost of accessing this repository. Useful for
weighing one repo's packages as greater/less than any other.
defaults to 1000
skip_if_unavailable If set to True yum will continue running if
this repository cannot be contacted for any reason. This should
be set carefully as all repos are consulted for any given com‐
mand. Defaults to False.
async If set to True Yum will download packages and metadata
from this repo in parallel, if possible. Defaults to True.
ui_repoid_vars Overrides the ui_repoid_vars option from the
[main] section for this repository.
URL INCLUDE SYNTAX
The inclusion of external configuration files is supported for
/etc/yum.conf and the .repo files in the /etc/yum.repos.d directory. To
include a URL, use a line of the following format:
include=url://to/some/location
The configuration file will be inserted at the position of the
"include=" line. Included files may contain further include lines. Yum
will abort with an error if an inclusion loop is detected.
GLOB: FOR LIST OPTIONS
Any of the configurations options which are a list of items can be
specfied using the glob syntax: glob:/etc/path/somewhere.d/*.conf. This
will read in all files matching that glob and include all lines in each
file (excluding comments and blank lines) as items in the list.
VARIABLES
There are a number of variables you can use to ease maintenance of
yum's configuration files. They are available in the values of several
options including name, baseurl and commands.
$releasever This will be replaced with the value of the version
of the package listed in distroverpkg. This defaults to the ver‐
sion of `redhat-release' package.
$arch This will be replaced with the architecture or your system
as detected by yum.
$basearch This will be replaced with your base architecture in
yum. For example, if your $arch is i686 your $basearch will be
i386.
$uuid This will be replaced with a unique but persistent uuid
for this machine. The value that is first generated will be
stored in /var/lib/yum/uuid and reused until this file is
deleted.
$YUM0-$YUM9 These will be replaced with the value of the shell
environment variable of the same name. If the shell environment
variable does not exist then the configuration file variable
will not be replaced.
As of 3.2.28, any file in /etc/yum/vars is turned into a variable named
after the filename (or overrides any of the above variables).
Note that no warnings/errors are given if the files are unreadable, so
creating files that only root can read may be confusing for users.
Also note that only the first line will be read and all new line char‐
acters are removed, as a convenience. However, no other checking is
performed on the data. This means it is possible to have bad character
data in any value.
FILES
/etc/yum.conf
/etc/yum.repos.d/
/etc/yum/pluginconf.d/
/etc/yum/protected.d
/etc/yum/vars
SEE ALSOyum(8)Seth Vidalyum.conf(5)
