AlmaLinux · andrewlukoshko · Jun 1, 2026 · Jun 1, 2026
diff --git a/...ess/public/images/ELevateNGCockpitUI.webp → ...press/public/images/ELevateCockpitUI.webp b/...ess/public/images/ELevateNGCockpitUI.webp → ...press/public/images/ELevateCockpitUI.webp
diff --git a/docs/elevate/ELevate-NG-testing-guide.md b/docs/elevate/ELevate-NG-testing-guide.md
@@ -267,6 +267,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
   In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
   :::
 
+  :::tip
+  You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
+  :::
+
 - The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems:
 
   ```bash
@@ -388,10 +392,6 @@ After these preparations are completed, you can upgrade your AlmaLinux 9 machine
 These steps can also be used to perform the upgrade from CentOS Stream 9 to CentOS Stream 10. The only difference is the `leapp-data` package.
 :::
 
-:::tip
-Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` extension (see the optional steps below) to inspect the upgrade report in a browser.
-:::
-
 - Install ELevate NG version repo config for AlmaLinux 9:
 
   ```bash
@@ -419,24 +419,6 @@ Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` ex
 
   :::
 
-- Install Cockpit and Leapp in-place upgrade Cockpit UI packages (optional):
-
-  ```bash
-  sudo yum install -y cockpit cockpit-leapp
-  ```
-
-- Start the Cockpit Web Service Socket, if not running (optional):
-
-  ```bash
-  sudo systemctl start cockpit.socket
-  ```
-
-- Log into Cockpit Web UI at `http://<your_ip_address>:9090`.
-
-  :::tip
-  Make sure the 9090 port is accessible.
-  :::
-
 - Start a preupgrade check. In the meanwhile, the Leapp utility creates a special _/var/log/leapp/leapp-report.txt_ file that contains possible problems and recommended solutions. No rpm packages will be installed at this phase.
 
   :::warning
@@ -456,9 +438,7 @@ Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` ex
   :::
 
   :::tip
-  If you installed the `cockpit-leapp` UI extension, you can review the preupgrade report directly in the Cockpit Web UI, as shown below:
-
-  ![Cockpit Web UI showing the Leapp preupgrade report](/images/ELevateNGCockpitUI.webp)
+  You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
   :::
 
 - Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 Beta goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0 Beta, please check the [known issues](#known-issues) section.

diff --git a/docs/elevate/ELevate-quickstart-guide.md b/docs/elevate/ELevate-quickstart-guide.md
@@ -135,6 +135,36 @@ sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/ce
   cat /var/log/leapp/leapp-upgrade.log
   ```
 
+## Inspecting the upgrade report in Cockpit Web UI
+
+Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` extension to inspect the Leapp upgrade report in a browser instead of reading _/var/log/leapp/leapp-report.txt_ directly.
+
+:::tip
+Cockpit is available when upgrading from AlmaLinux 8 or AlmaLinux 9.
+:::
+
+- Install Cockpit and the Leapp in-place upgrade Cockpit UI packages:
+
+  ```bash
+  sudo yum install -y cockpit cockpit-leapp
+  ```
+
+- Start the Cockpit Web Service Socket, if not running:
+
+  ```bash
+  sudo systemctl start cockpit.socket
+  ```
+
+- Log into Cockpit Web UI at `http://<your_ip_address>:9090`.
+
+  :::tip
+  Make sure the 9090 port is accessible.
+  :::
+
+- After running `leapp preupgrade`, you can review the preupgrade report directly in the Cockpit Web UI, as shown below:
+
+  ![Cockpit Web UI showing the Leapp preupgrade report](/images/ELevateCockpitUI.webp)
+
 ### Demo Video
 
 Here we have provided a demo of a CentOS 7.x to AlmaLinux 8.x upgrade using the AlmaLinux ELevate Project.

diff --git a/docs/elevate/ELevate-testing-guide.md b/docs/elevate/ELevate-testing-guide.md
@@ -232,6 +232,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
   In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
   :::
 
+  :::tip
+  You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
+  :::
+
 - The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems:
 
   ```bash
@@ -413,6 +417,10 @@ The only difference is the `leapp-data` package.
   In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
   :::
 
+  :::tip
+  You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
+  :::
+
 - Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0, please check the [known issues](#known-issues) section.
 
   :::tip

diff --git a/docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md b/docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md
@@ -224,6 +224,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
   In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
   :::
 
+  :::tip
+  You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
+  :::
+
 - The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems:
 
   ```bash
@@ -400,6 +404,10 @@ The only difference is the `leapp-data` package.
   In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
   :::
 
+  :::tip
+  You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
+  :::
+
 - Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0, please check the [known issues](#known-issues) section.
 
   :::tip