Getting started with EPEL

To enable the EPEL repository on your system, install the appropriate release package as described below. These packages contain the repository configuration and public package signing key.

Some EPEL packages depend on packages from repositories that are not enabled by default. Take note of the additional repositories being enabled in the instructions on this page.

For convenience, some distributions include copies of EPEL release packages in their default repositories, allowing you to install them by name without the full URL. The EPEL project recommends using the official permalinks on this page to ensure the best experience.

Release package permalinks

EL10

CentOS Stream 10

dnf config-manager --set-enabled crb
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm

EL9

EPEL 9 has two different release packages. If you are using RHEL 9, only install the epel-release package. If you are using CentOS Stream 9, install both the epel-release and epel-next-release packages.

CentOS Stream 9

dnf config-manager --set-enabled crb
dnf install https://dl.fedoraproject.org/pub/epel/epel{,-next}-release-latest-9.noarch.rpm

RHEL 9

subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

Other RHEL 9 compatible distributions

EPEL 9 officially targets CentOS Stream 9 and RHEL 9. EPEL 9 packages will also likely work with other distributions that target RHEL 9 compatibility. We cannot list specific instructions for all such distributions, but in general the steps needed should look similar to the steps for RHEL 9. First enable the distribution’s equivalent of the CRB repository, then install the epel-release package.

dnf config-manager --set-enabled crb
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

EL8

RHEL 8

subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

Other RHEL 8 compatible distributions

EPEL 8 officially targets RHEL 8. EPEL 8 packages will also likely work with other distributions that target RHEL 8 compatibility. We cannot list specific instructions for all such distributions, but in general the steps needed should look similar to the steps for RHEL 8. First enable the distribution’s equivalent of the PowerTools/CRB repository, then install the epel-release package.

dnf config-manager --set-enabled powertools
dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

Previous versions (End-of-life releases)

End-of-life releases are no longer supported.

Due to major security changes in SSL in the last 10 years, older releases may not be able to directly point to these releases. As of 2021-01-22, EPEL-5 and 4 systems do not have the newer TLS 1.2 algorithms that Internet servers are required to use for security reasons. The best method for working with these is to have a newer system mirror the entire archive and then for your systems to point to that mirror.

Want to help? Learn how to contribute to Fedora Docs ›