docker · aevesdocker · Mar 22, 2024 · Jan 18, 2024
diff --git a/content/desktop/install/fedora.md b/content/desktop/install/fedora.md
@@ -22,12 +22,12 @@ This page contains information on how to install, launch and upgrade Docker Desk
 
 To install Docker Desktop successfully, you must:
 
-- Meet the [system requirements](linux-install.md#system-requirements).
+- Meet the [system requirements](linux-install.md#general-system-requirements).
 - Have a 64-bit version of either Fedora 38 or Fedora 39.
 
-Additionally, for a Gnome Desktop environment you must install AppIndicator and KStatusNotifierItem [Gnome extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
+Additionally, for a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem [GNOME extensions](https://extensions.gnome.org/extension/615/appindicator-support/).
 
-For non-Gnome Desktop environments, `gnome-terminal` must be installed:
+For non-GNOME desktop environments, `gnome-terminal` must be installed:
 
 ```console
 $ sudo dnf install gnome-terminal
@@ -74,4 +74,4 @@ $ sudo dnf install ./docker-desktop-<version>-<arch>.rpm
 
 - Take a look at the [Get started](../../guides/get-started/_index.md) training modules to learn how to build an image and run it as a containerized application.
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
-- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
+- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
diff --git a/content/desktop/install/linux-install.md b/content/desktop/install/linux-install.md
@@ -124,11 +124,12 @@ and architectures:
 
 
 
-| Platform                | x86_64 / amd64         | 
-|:-----------------------|:-----------------------:|
-| [Ubuntu](ubuntu.md)     | ✅ |
-| [Debian](debian.md)     | ✅  |
-| [Fedora](fedora.md)     | ✅ |
+| Platform                | x86_64 / amd64          | 
+|:------------------------|:-----------------------:|
+| [Ubuntu](ubuntu.md)                         | ✅  |
+| [Debian](debian.md)                         | ✅  |
+| [Red Hat Enterprise Linux (RHEL)](rhel.md)  | ✅  |
+| [Fedora](fedora.md)                         | ✅  |
 
 
 An experimental package is available for [Arch](archlinux.md)-based distributions. Docker has not tested or verified the installation.
@@ -215,12 +216,13 @@ Sign out and sign back in so that your group membership is re-evaluated.
 > Make sure you meet the system requirements outlined earlier and follow the distro-specific prerequisites.
 { .important } 
 
-1. Download the correct package for your Linux distribution and install it with the corresponding package manager. 
+1. Download the correct package for your Linux distribution and install it with the corresponding package manager.
+   - [Install on Ubuntu](ubuntu.md)
    - [Install on Debian](debian.md)
+   - [Install on Red Hat Enterprise Linux (RHEL)](rhel.md)
    - [Install on Fedora](fedora.md)
-   - [Install on Ubuntu](ubuntu.md)
-   - [Install on Arch](archlinux.md) 
-   By default, Docker Desktop is installed at `/opt/docker-desktop`.
+   - [Install on Arch](archlinux.md)
+  By default, Docker Desktop is installed at `/opt/docker-desktop`.
 
 2. Open your **Applications** menu in Gnome/KDE Desktop and search for **Docker Desktop**.
 

diff --git a/content/desktop/install/rhel.md b/content/desktop/install/rhel.md
@@ -0,0 +1,136 @@
+---
+description: Instructions for installing Docker Desktop on RHEL
+keywords: red hat, red hat enterprise linux, rhel, rpm,
+  update install, uninstall, upgrade, update, linux,
+  desktop, docker desktop, docker desktop for linux, dd4l
+title: Install Docker Desktop on RHEL
+toc_max: 4
+download-url-base: https://download.docker.com/linux/rhel
+---
+
+> **Docker Desktop terms**
+>
+> Commercial use of Docker Desktop in larger enterprises (more than 250
+> employees OR more than $10 million USD in annual revenue) requires a [paid
+> subscription](https://www.docker.com/pricing/).
+
+This page contains information on how to install, launch and upgrade Docker Desktop on a Red Hat Enterprise Linux (RHEL) distribution.
+
+{{< button text="RPM package" url="https://desktop.docker.com/linux/main/amd64/docker-desktop-4.28-x86_64-rhel.rpm?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64" >}}
+
+## Prerequisites
+
+To install Docker Desktop successfully, you must:
+
+- Meet the [system requirements](linux-install.md#general-system-requirements).
+- Have a 64-bit version of either RHEL 8 or RHEL 9.
+
+If you don't have `pass` installed, or it can't be installed, you must enable
+[CodeReady Linux Builder (CRB) repository](https://access.redhat.com/articles/4348511)
+and
+[Extra Packages for Enterprise Linux (EPEL)](https://docs.fedoraproject.org/en-US/epel/).
+
+   {{< tabs group="os_version" >}}
+   {{< tab name="RHEL 9" >}}
+```console
+$ sudo subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms
+$ sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
+$ sudo dnf install pass
+```
+
+   {{< /tab >}}
+   {{< tab name="RHEL 8" >}}
+```console
+$ sudo subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms
+$ sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
+$ sudo dnf install pass
+```
+
+   {{< /tab >}}
+   {{< /tabs >}}
+
+Additionally, for a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem [GNOME extensions](https://extensions.gnome.org/extension/615/appindicator-support/). You must also enable EPEL.
+
+   {{< tabs group="os_version" >}}
+   {{< tab name="RHEL 9" >}}
+```console
+$ # enable EPEL as described above
+$ sudo dnf install gnome-shell-extension-appindicator
+$ sudo gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com
+```
+
+   {{< /tab >}}
+   {{< tab name="RHEL 8" >}}
+```console
+$ # enable EPEL as described above
+$ sudo dnf install gnome-shell-extension-appindicator
+$ sudo dnf install gnome-shell-extension-desktop-icons
+$ sudo gnome-shell-extension-tool -e appindicatorsupport@rgcjonas.gmail.com
+```
+
+   {{< /tab >}}
+   {{< /tabs >}}
+
+For non-GNOME desktop environments, `gnome-terminal` must be installed:
+
+```console
+$ sudo dnf install gnome-terminal
+```
+
+## Install Docker Desktop
+
+To install Docker Desktop on RHEL:
+
+1. Set up Docker's package repository as follows:
+
+   ```console
+   $ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce.repo
+   ```
+
+2. Download latest [RPM package](https://desktop.docker.com/linux/main/amd64/docker-desktop-4.28-x86_64-rhel.rpm?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64).
+
+3. Install the package with dnf as follows:
+
+   ```console
+   $ sudo dnf install ./docker-desktop-<version>-<arch>-rhel.rpm
+   ```
+
+There are a few post-install configuration steps done through the post-install script contained in the RPM package.
+
+The post-install script:
+
+- Sets the capability on the Docker Desktop binary to map privileged ports and set resource limits.
+- Adds a DNS name for Kubernetes to `/etc/hosts`.
+- Creates a symlink from `/usr/local/bin/com.docker.cli` to `/usr/bin/docker`.
+  This is because the classic Docker CLI is installed at `/usr/bin/docker`. The Docker Desktop installer also installs a Docker CLI binary that includes cloud-integration capabilities and is essentially a wrapper for the Compose CLI, at`/usr/local/bin/com.docker.cli`. The symlink ensures that the wrapper can access the classic Docker CLI. 
+- Creates a symlink from `/usr/libexec/qemu-kvm` to `/usr/local/bin/qemu-system-x86_64`.
+
+## Launch Docker Desktop
+
+{{< include "desktop-linux-launch.md" >}}
+
+>**Tip**
+>
+> To attach Red Hat subscription data to containers, see [Red Hat verified solution](https://access.redhat.com/solutions/5870841).
+>
+> For example:
+> ```console
+> $ docker run --rm -it -v "/etc/pki/entitlement:/etc/pki/entitlement" -v "/etc/rhsm:/etc/rhsm-host" -v "/etc/yum.repos.d/redhat.repo:/etc/yum.repos.d/redhat.repo" registry.access.redhat.com/ubi9
+> ```
+{ .tip }
+
+## Upgrade Docker Desktop
+
+Once a new version for Docker Desktop is released, the Docker UI shows a notification.
+You need to first remove the previous version and then download the new package each time you want to upgrade Docker Desktop. Run:
+
+```console
+$ sudo dnf remove docker-desktop
+$ sudo dnf install ./docker-desktop-<version>-<arch>-rhel.rpm
+```
+
+## Next steps
+
+- Take a look at the [Get started](../../guides/get-started/_index.md) training modules to learn how to build an image and run it as a containerized application.
+- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
+- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
diff --git a/data/toc.yaml b/data/toc.yaml
@@ -1088,12 +1088,14 @@ Manuals:
          title: Install on Linux
        - sectiontitle: Installation per Linux distro
          section:
+            - path: /desktop/install/ubuntu/
+              title: Install on Ubuntu
             - path: /desktop/install/debian/
               title: Install on Debian
+            - path: /desktop/install/rhel/
+              title: Install on RHEL {{< badge color=violet text=New >}}
             - path: /desktop/install/fedora/
               title: Install on Fedora
-            - path: /desktop/install/ubuntu/
-              title: Install on Ubuntu
             - path: /desktop/install/archlinux/
               title: Install on Arch
     - path: /desktop/get-started/