Create getting started page

This commit is contained in:
Carl George 2023-04-19 00:57:45 -05:00 • committed by Carl George
commit 614f07de6e
4 changed files with 75 additions and 129 deletions

View file

@ -1,4 +1,4 @@
* Getting Started
* xref:getting-started.adoc[Getting Started]
* Available Packages
* Request Package
* Policy

View file

@ -0,0 +1,71 @@
= Getting Started
CAUTION: 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.
NOTE: 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 URLs to the official packages to ensure the best experience.
== EL9
EPEL 9 officially targets RHEL 9 and CentOS Stream 9.
If you are using RHEL 9, install `epel-release`.
If you are using CentOS Stream 9, install *both* `epel-release` and `epel-next-release`.
* https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm[epel-release-latest-9]
* https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-9.noarch.rpm[epel-next-release-latest-9]
=== 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 packages will also likely work with distributions that target RHEL 9 compatibility.
We cannot list specific instructions for all such distributions,
but in general the steps will look similar to the steps for RHEL 9.
First enable the distribution's equivalent of the CRB repository,
then install the https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm[epel-release-latest-9] package.
== EL8
We offer the following release packages for the EL8 family.
If you are using RHEL or a RHEL derivative, install `epel-release`.
If you are using CentOS Stream, install *both* `epel-release` and `epel-next-release`.
* https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm[epel-release-latest-8]
* https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-8.noarch.rpm[epel-next-release-latest-8]
=== CentOS Stream 8
----
dnf config-manager --set-enabled powertools
dnf install https://dl.fedoraproject.org/pub/epel/epel{,-next}-release-latest-8.noarch.rpm
----
=== 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 packages will also likely work with distributions that target RHEL 8 compatibility.
We cannot list specific instructions for all such distributions,
but in general the steps will look similar to the steps for RHEL 8.
First enable the distribution's equivalent of the CRB (or PowerTools) repository,
then install the https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm[epel-release-latest-8] package.

View file

@ -16,3 +16,6 @@ be maintained in similar ways to packages from the default repositories.
EPEL is governed by the EPEL Steering Committee.
All Fedora maintainers who build for EPEL are part of the initiative.
Some of these maintainers collaborate in the EPEL Packagers Special Interest Group.
TIP: Ready to get started?
Check out or xref:getting-started.adoc[setup guide].

View file

@ -1,91 +1,6 @@
include::partial$attributes.adoc[]
= Extra Packages for Enterprise Linux (EPEL)
== Quickstart
We offer release packages containing our repository configuration files and public package signing keys.
Use the version that corresponds to the major version of your operating system.
* https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm[epel-release-latest-9]
* https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm[epel-release-latest-8]
* https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm[epel-release-latest-7]
If you are using CentOS Stream, we also recommend installing the corresponding epel-next-release package.
* https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-9.noarch.rpm[epel-next-release-latest-9]
* https://dl.fedoraproject.org/pub/epel/epel-next-release-latest-8.noarch.rpm[epel-next-release-latest-8]
For convenience some distributions include these release packages in their default repositories,
allowing you to install them by name without the full URL.
Some EPEL packages depend on packages from repositories that are not enabled by default.
Take note of the additional repositories being enabled in the following instructions.
=== EL9
==== CentOS Stream 9
....
dnf config-manager --set-enabled crb
dnf install epel-release epel-next-release
....
==== 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
....
==== AlmaLinux 9, Rocky Linux 9
....
dnf config-manager --set-enabled crb
dnf install epel-release
....
=== EL8
==== CentOS Stream 8
....
dnf config-manager --set-enabled powertools
dnf install epel-release epel-next-release
....
==== 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
....
==== AlmaLinux 8, Rocky Linux 8
....
dnf config-manager --set-enabled powertools
dnf install epel-release
....
=== EL7
==== RHEL 7
....
subscription-manager repos --enable rhel-*-optional-rpms \
--enable rhel-*-extras-rpms \
--enable rhel-ha-for-rhel-*-server-rpms
yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
....
==== CentOS 7
....
yum install epel-release
....
[[what_is_epel_next]]
== What is EPEL-Next?
@ -145,49 +60,6 @@ entire archive and then for your systems to point to that mirror.
* EPEL 5: https://dl.fedoraproject.org/pub/archive/epel/5/[]
* EPEL 4: https://dl.fedoraproject.org/pub/archive/epel/4/[]
[[how_can_i_use_these_extra_packages]]
== How can I use these extra packages?
EPEL has an 'epel-release' package that includes GPG keys for package
signing and repository information. Installing this package for your
Enterprise Linux version should allow you to use normal tools such as
`yum` to install packages and their dependencies. By default the stable
EPEL repo is enabled, there is also a link:epel-testing['epel-testing'
repository] that contains packages that are not yet deemed stable.
* NOTE for RHN users: You need to also enable the *'optional*' repository
to use EPEL packages as they depend on packages in that repository. This
can be done by enabling the RHEL optional
https://access.redhat.com/kb/docs/DOC-11313[subchannel] for RHN-Classic.
For certificate-based subscriptions see
https://access.redhat.com/site/documentation/en-US/Red_Hat_Subscription_Management/1/html/RHSM/entitlements-and-yum.html#supplementary-repos[Red
Hat Subscription Management Guide].
* NOTE for RHEL 7 users with certificate subscriptions: EPEL 7 packages
assume that the *'optional*' repository (rhel-7-server-optional-rpms for
servers) and the *'extras*' repository (rhel-7-server-extras-rpms for
servers) are enabled. You can do this with:
`subscription-manager repos --enable rhel-7-server-optional-rpms --enable rhel-7-server-extras-rpms`
* NOTE for RHEL 8 users with certificate subscriptions: EPEL packages
assume that the *'codeready-builder*' repository is enabled. You can do
this with:
`subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms"`
* NOTE for CentOS 8 and CentOS Stream 8 users: EPEL packages assume that the *'powertools*'
repository is enabled. You can do this with:
`dnf config-manager --set-enabled powertools`
* NOTE for CentOS users: You can install EPEL by running *yum install
epel-release*. The package is included in the CentOS Extras repository,
enabled by default.
You can verify these packages and their keys from the Fedora project's
keys page: https://fedoraproject.org/keys
[[can_i_rely_on_these_packages]]
== Can I rely on these packages?