Upgrade OS: RHEL 7 to RHEL 8#


Instructions here are provided here on a best effort basis, and without warranty.

For authoritative documentation to upgrade RHEL 7 to RHEL 8, refer to the official Red Hat documentation


This guide does not contain instructions for offline upgrades. Instead, see the official documentation:

This section provides instructions on how to upgrade RHEL 7 to RHEL 8.


  • Familiarity with the terminal

  • Root access to the RHEL host.

  • Red Hat Enterprise Linux Server subscription or similar.

Prepare RHEL 7 host for upgrade#

Prepare your RHEL 7 host for upgrade by following these steps. In the terminal, run as root:

  1. Disable SELinux for the period of the upgrade.:

    setenforce 0
  2. Make sure that you are registered through subscription-manager:

    subscription-manager list --installed
  3. Make sure that you have the following repositories enabled:

    subscription-manager repos --enable rhel-7-server-rpms             // Enable the Base repository:
    subscription-manager repos --enable rhel-7-server-extras-rpms      // Enable the Extras repository where Leapp and its dependencies are available
    subscription-manager release --unset                               // Set the Red Hat Subscription Manager to use the latest RHEL 7 content
  4. (Optional) Make sure versionlock is cleared if you use yum-plugin-versionlock:

    yum versionlock clear
  5. Update all installed packages:

    yum update -y
  6. Restart the host:

  7. Install Leapp:

    yum install -y leapp leapp-repository leapp-upgrade

Perform the upgrade#

Run as root:

  1. The Leapp upgrade command:

    leapp upgrade --target <target_os_version>

    For available <target_os_version> values, see Red Hat: Upgrading from RHEL 7 to RHEL 8: Supported upgrade paths

  2. Once complete, reboot the system. Run as root: