Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 10. Managing custom software repositories

You can configure a repository in the /etc/yum.conf file. or in a .repo file in the /etc/yum.repos.d/ directory.

Note

It is recommended to define your repositories in the new or existing .repo file in /etc/yum.repos.d/ because all files with the .repo file extension are read by YUM.

The /etc/yum.conf file contains the [main] sections and can contain one or more repository sections ([<repository_ID>]) that you can use to set repository-specific options. The values you define in individual repository sections of the /etc/yum.conf file override values set in the [main] section.

10.1. YUM repository options
Copy link

The /etc/yum.conf configuration file contains the repository sections with a repository ID in brackets ([<repository_ID>]). You can use these sections to define individual YUM repositories.

Important

Repository IDs must be unique.

For a complete list of available repository ID options, see the [<repository_ID>] OPTIONS section of the dnf.conf(5) man page on your system.

10.2. Adding a YUM repository
Copy link

You can add a YUM repository to your system by defining it in the .repo file in the /etc/yum.repos.d/ directory.

Procedure

  1. Add a repository to your system: 

    # yum-config-manager --add-repo <repository_URL>
    Copy to Clipboard Toggle word wrap

    Note that repositories added by this command are enabled by default.

  2. Review and, optionally, update the repository settings that the previous command has created in the /etc/yum.repos.d/<repository_URL>.repo file: 

    # cat /etc/yum.repos.d/<repository_URL>.repo
    Copy to Clipboard Toggle word wrap
Warning

Obtaining and installing software packages from unverified or untrusted sources other than Red Hat certificate-based Content Delivery Network (CDN) is a potential security risk, and can lead to security, stability, compatibility, and maintainability issues.

10.3. Enabling a YUM repository
Copy link

Once you added a YUM repository to your system, enable it to ensure installation and updates.

Procedure

  • Enable a repository: 

    # yum-config-manager --enable <repository_id>
    Copy to Clipboard Toggle word wrap

10.4. Disabling a YUM repository
Copy link

To to prevent particular packages from installation or update, you can disable a YUM repository that contains these packages.

Procedure

  • Disable a repository: 

    # yum-config-manager --disable <repository_id>
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat