Product SiteDocumentation Site

Fedora Core 5

Managing Software with yum

Stuart Ellis

Edited by

Paul W. Frields

Legal Notice

Copyright © 2006 Red Hat, Inc. and others.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at The original authors of this document, and Red Hat, designate the Fedora Project as the "Attribution Party" for purposes of CC-BY-SA. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
For guidelines on the permitted uses of the Fedora trademarks, refer to
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
All other trademarks are the property of their respective owners.
Documentation for the yum software management system.

1. Introduction
1.1. Purpose
1.2. Audience
1.3. Using This Document
1.4. Additional Resources
2. Software Management Concepts
2.1. About Packages
2.2. About Repositories
2.3. About Dependencies
2.4. Understanding Package Names
3. Software Management Tools in Fedora Core
4. Managing Software with yum
4.1. Installing New Software with yum
4.2. Updating Software with yum
4.3. Removing Software with yum
5. Searching for Packages with yum
5.1. Searching by Package Name and Attributes
5.2. Advanced Searches
5.3. Understanding Matches
6. Updating Your System with yum
6.1. Automatically Updating Your System
7. Configuring Access to Software Repositories
7.1. Adding a Repository as a Package Source
7.2. Manually Authorizing Package Sources
7.3. Understanding Repository Compatibility
7.4. Disabling or Removing Package Sources
8. Installing Software from an Isolated Package
9. Customizing yum
9.1. Editing the yum Configuration
9.2. Working with yum Plugins
10. Working with yum Caching
10.1. Enabling the Caches
10.2. Using yum in Cache-only Mode
10.3. Clearing the yum Caches
11. Using yum with a Proxy Server
11.1. Configuring Proxy Server Access
11.2. Configuring Proxy Server Access for a Single User
12. Acknowledgments

1. Introduction

1.1. Purpose

This document presents basic concepts of software management on Fedora systems. It outlines the major functions of yum, the recommended software management tool for Fedora.

1.2. Audience

This document is intended for Fedora users of all levels of experience.

1.3. Using This Document

This document is a reference for using yum. You may wish to read some or all of the sections, depending upon your needs and level of experience. If you are a new user, read Section 2, “Software Management Concepts” before using yum for the first time. Experienced Linux users should start with Section 4, “Managing Software with yum.

Previous Versions of Fedora Core

This document describes the configuration of yum on current versions of Fedora Core. You must perform the additional step noted in Section 7.2, “Manually Authorizing Package Sources” to enable yum on Fedora Core 3.
Most of the examples in this document use the package tsclient, which is included with Fedora Core. The tsclient package provides an application for remote desktop access. If you install it successfully you may start the application by choosing ApplicationsInternetTerminal Server Client. To use the examples, substitute the name of the relevant package for tsclient. The example commands for Fedora package groups use the MySQL Database group.

Avoid Logging in with the Root Account

You do not need to log in with the root account in order to manage your Fedora system. All of the commands shown in this tutorial that require root access will prompt you for the root password. The example terminal commands use su -c to provide this facility.
Fedora Core includes a yum configuration that is suitable for independent systems with Internet access. You may use yum and related software on such systems without any additional configuration.
If your system is part of a managed network, consult your network administrators for advice. You may need to configure yum to use a network proxy server. Section 11, “Using yum with a Proxy Server” explains how to configure yum to use a proxy server. Administrators may also suggest or require that yum clients use specific package repositories. Refer to Section 7, “Configuring Access to Software Repositories” for instructions on how to configure access to repositories.
To improve performance and enable disconnected operations, activate the yum caches on your system. Refer to Section 10, “Working with yum Caching” for more information on the caching option.

1.4. Additional Resources

The yum utility has features and options not discussed in this document. Read the man pages for yum(8) and yum.conf(5) to learn more, using the following commands:
man yum man yum.conf
Other useful yum resources on the Internet include:

Check Bugzilla First

If you encounter a persistent error with a specific operation, visit and review the bug reports for the package or packages involved. An error in a package may cause all yum operations that rely on that package to fail. Please file bug reports for Fedora packages, including yum, on this Bugzilla web site.