Skip to content

Update repository information on RHEL-based distros #605

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
fluoros-jp wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Update repository information on RHEL-based distros #605

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f7a3415
Correct link to current release packages
fluoros-jp Jan 28, 2026
d85b16c
Update repository information on RHEL based distros
fluoros-jp Jan 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 54 additions & 18 deletions docs/Getting Started/RHEL-based distro/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ encouraged to verify the authenticity of the OpenZFS public key using
the fingerprint listed here.

| **Key location:** /etc/pki/rpm-gpg/RPM-GPG-KEY-openzfs (previously -zfsonlinux)
| **Current release packages:** `EL7`_, `EL8`_, `EL9`_
| **Current release packages:** `EL7`_, `EL8`_, `EL9`_, `EL10`_
| **Archived release packages:** `see repo page <https://github.com/zfsonlinux/zfsonlinux.github.com/tree/master/epel>`__

| **Signing key1 (EL8 and older, Fedora 36 and older)**
Expand Down Expand Up @@ -59,7 +59,7 @@ package, then the *kernel-devel* and *zfs* packages. Note that it is
important to make sure that the matching *kernel-devel* package is installed
for the running kernel since DKMS requires it to build OpenZFS.

For EL6 and 7, separately run::
For EL7, separately run::

yum install -y epel-release
yum install -y kernel-devel
Expand All @@ -86,7 +86,7 @@ install the kABI-tracking kmods the default repository must be switched
from *zfs* to *zfs-kmod*. Keep in mind that the kABI-tracking kmods are
only verified to work with the distribution-provided, non-Stream kernel.

For EL6 and 7 run::
For EL7 run::

yum-config-manager --disable zfs
yum-config-manager --enable zfs-kmod
Expand Down Expand Up @@ -140,31 +140,66 @@ will be aliased to the current minor version (e.g. `8.7`), but you can specify

In the above example, the former packages were built for EL8.7, and the latter for EL8.6.

Testing Repositories
--------------------
Latest Repositories
-------------------

In addition to the primary *zfs* repository a *zfs-testing* repository
is available. This repository, which is disabled by default, contains
the latest version of OpenZFS which is under active development. These
packages are made available in order to get feedback from users regarding
*zfs-latest* repository, which is disabled by default, contains the latest released
version of OpenZFS which is under active development.
These packages are made available in order to get feedback from users regarding
the functionality and stability of upcoming releases. These packages
**should not** be used on production systems. Packages from the testing
**should not** be used on production systems. Packages from the latest
repository can be installed as follows.

For EL6 and 7 run::
For EL8 and newer run::

yum-config-manager --enable zfs-testing
yum install kernel-devel zfs
dnf config-manager --enable zfs-latest
dnf install kernel-devel zfs

And for EL8 and newer::
.. note::
Use *zfs-latest* for DKMS packages and *zfs-latest-kmod*
for kABI-tracking kmod packages.

Legacy Repositories
-------------------

*zfs-legacy* repository, which is disabled by default, contains the previous
ZFS major version that is still being actively updated.
Typically, this repository provides same packages as primary *zfs* repository
for RHEL- and CentOS-based distribution.
Packages from the legacy repository can be installed as follows.

For EL8 and newer run::

dnf config-manager --enable zfs-legacy
dnf install kernel-devel zfs

dnf config-manager --enable zfs-testing
.. note::
Use *zfs-legacy* for DKMS packages and *zfs-legacy-kmod*
for kABI-tracking kmod packages.

Version Specific Repositories
-----------------------------

Version specific repositories are provided for users who wants to run a specific
branch (e.g. `2.3.x`) of ZFS.
Packages from the version specific repository can be installed as follows.

For EL8 and newer, to enable version specific repository for ZFS branch x.y, run::

dnf config-manager --enable zfs-x.y
dnf install kernel-devel zfs

.. note::
Use *zfs-testing* for DKMS packages and *zfs-testing-kmod*
Use *zfs-x.y* for DKMS packages and *zfs-x.y-kmod*
for kABI-tracking kmod packages.

Testing Repositories (DEPRECATED)
---------------------------------

*zfs-testing* and *zfs-testing-kmod* repositories are DEPRECATED
in favor of 'zfs-latest'.


Root on ZFS
-----------
.. toctree::
Expand All @@ -176,6 +211,7 @@ Root on ZFS
.. _kABI-tracking kmod: https://elrepoproject.blogspot.com/2016/02/kabi-tracking-kmod-packages.html
.. _DKMS: https://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support
.. _EL7: https://zfsonlinux.org/epel/zfs-release-2-3.el7.noarch.rpm
.. _EL8: https://zfsonlinux.org/epel/zfs-release-2-3.el8.noarch.rpm
.. _EL9: https://zfsonlinux.org/epel/zfs-release-2-3.el9.noarch.rpm
.. _EL8: https://zfsonlinux.org/epel/zfs-release-3-0.el8.noarch.rpm
.. _EL9: https://zfsonlinux.org/epel/zfs-release-3-0.el9.noarch.rpm
.. _EL10: https://zfsonlinux.org/epel/zfs-release-3-0.el10.noarch.rpm
.. _EPEL repository: https://fedoraproject.org/wiki/EPEL