View source for Docs/Drafts/SoftwareManagementGuide/ConfiguringRepositories

== 7. Configuring Access to Software Repositories ==

Fedora systems automatically use the Fedora Project repositories. If the Fedora Project does not supply packages for a product, the manufacturer may provide or recommend a separate repository. Members of the community also maintain repositories to provide packages for Fedora systems. For example, http://www.jpackage.org/ distributes popular Java software as packages.

== 7.1. Adding a Repository as a Package Source ==

To add an extra repository, place a definition file in the <code>/etc/yum.repos.d/</code> directory on your system. Package providers make the definition files for their repositories available on their web sites.

{| border="1"
|-
| {{Template:Tip}} '''Definition File Extension'''
|-
| The names of repository definition files end with <code>.repo</code>.
|}

You must have ''root'' access to add a file to the definitions directory. To copy the definition file <code>example.repo</code>, type this command:

<code> su -c 'cp example.repo /etc/yum.repos.d/' </code>

At the prompt, enter the password for the ''root'' account.

The configuration file for each repository should include a <code>gpgkey</code> setting. This setting specifies the location of a public key that verifies the packages provided by that repository. This public key is automatically imported the first time that you install software from the repository. If the configuration file provided does not include this setting, refer to Section 7.2, “Manually Authorizing Package Sources”.

{{Anchor|manually_authorizing}}
== 7.2. Manually Authorizing Package Sources ==

To manually add a public key to your <code>rpm</code> keyring, use the import feature of the <code>rpm</code> utility. To import the file <code>GPG-PUB-KEY.asc</code>, type the following command:

<code> su -c 'rpm --import GPG-PUB-KEY.asc' </code>

At the prompt, enter the password for the ''root'' account.

You may also import public keys directly from a web site. For example, to import the file <code>GPG-PUB-KEY.asc</code> on the web site ''www.therepository.com'', use this command:

<code> su -c 'rpm --import http://www.therepository.com/GPG-PUB-KEY.asc' </code>

At the prompt, enter the ''root'' password.

{| border="1"
|-
| {{Template:Important}} '''Importing the Fedora Key'''
|-
| To add the Fedora public key to the <code>rpm</code> keyring on Fedora systems, run the command <code>su -c 'rpm --import /usr/share/rhn/RPM-GPG-KEY-fedora'</code>.
|}

== 7.3. Understanding Repository Compatibility ==

The Fedora Package Collection includes several thousands of packages which are compatible with each other. Third-party packages should be compatible with these Fedora Project packages, unless the provider specifically states otherwise.

Always read the web site of the repository for information on package compatibility before you add it as a package source. Separate repository providers may offer different and incompatible versions of the same software. Third-party repositories may also provide alternative packages for software that is included in Fedora repositories.

Alternative packages may contain versions of the software that function differently from the version in the Fedora Project packages. Determine the benefits and potential incompatibilities before replacing Fedora Project packages with alternative versions.

{| border="1"
|-
| {{Template:Caution}} '''Incompatible Repositories'''
|-
| If you configure your system to use incompatible repositories yum operations may fail.
|}

Packages built for one version of Fedora are usually not compatible with other versions of Fedora. The web site of the provider should specifically state which versions of Fedora they support.

{| border="1"
|-
| {{Template:Tip}} '''Old Versions of yum and Current Repositories'''
|-
| The data format for repository indexes changed with version 2.1 of <code>yum</code>. This was the version supplied with Fedora Core 3. Repository providers should specify the versions of Fedora that they support. To confirm that an unlabeled repository is compatible with current versions of <code>yum</code>, check that it has a sub-directory called <code>repodata/</code>.
|}

== 7.4. Disabling or Removing Package Sources ==

Set <code>enabled=0</code> in a definition file to prevent <code>yum</code> from using that repository. The <code>yum</code> utility ignores any definition file with this setting.

To completely remove access to a repository:

1. Delete the relevant file from <code>/etc/yum.repos.d/</code>.
2. Delete the cache directory from <code>/var/cache/yum/</code>.

{| border="1"
|-
|[[Docs/Drafts/SoftwareManagementGuide/UpdateWithYum| Previous Page - 6. Updating Your System with yum]] ||[[Docs/Drafts/SoftwareManagementGuide| Table of Contents]] ||[[Docs/Drafts/SoftwareManagementGuide/IsolatedInstall| Next Page - 8. Installing Software from an Isolated Package]]