yum Cookbook

Cookbook Version (opens in a new tab) CI State (opens in a new tab) OpenCollective OpenCollective License (opens in a new tab)

The Yum cookbook exposes the yum_globalconfig resource which allows a user to control global yum behavior. This resources aims to allow the user to configure all options listed in the yum.conf man page, found at (opens in a new tab)


This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit (opens in a new tab) or come chat with us on the Chef Community Slack in #sous-chefs (opens in a new tab).



  • RHEL/CentOS and derivatives
  • Fedora


  • Chef 15.3+


  • none


Recipes (deprecated)

  • default - Configures yum_globalconfig[/etc/yum.conf] with values found in node attributes at node['yum']['main']


The following attributes are set by default

default['yum']['main']['cachedir'] = '/var/cache/yum/$basearch/$releasever'
default['yum']['main']['keepcache'] = false
default['yum']['main']['debuglevel'] = nil
default['yum']['main']['exclude'] = nil
default['yum']['main']['logfile'] = '/var/log/yum.log'
default['yum']['main']['exactarch'] = nil
default['yum']['main']['obsoletes'] = nil
default['yum']['main']['installonly_limit'] = nil
default['yum']['main']['installonlypkgs'] = nil
default['yum']['main']['installroot'] = nil

For Amazon platform nodes, the default is to receive a continuous flow of updates,

default['yum']['main']['releasever'] = 'latest'

To lock existing instances to the current version of the Amazon AMI,

default['yum']['main']['releasever'] = ''

Related Cookbooks

Recipes from older versions of this cookbook have been moved individual cookbooks. Recipes for managing platform yum configurations and installing specific repositories can be found in one (or more!) of the following cookbook.

  • yum-centos
  • yum-fedora
  • yum-amazon
  • yum-epel
  • yum-elrepo
  • yum-repoforge
  • yum-ius
  • yum-percona
  • yum-pgdg


Put depends 'yum' in your metadata.rb to gain access to the yum_repository resource.


This project exists thanks to all the people who contribute. (opens in a new tab)


Thank you to all our backers!


Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

Was this helpful?