content/manuals/desktop/setup/install/linux/rhel.md
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.
This page contains information on how to install, launch and upgrade Docker Desktop on a Red Hat Enterprise Linux (RHEL) distribution.
To install Docker Desktop successfully, you must:
Meet the general system requirements.
Have a 64-bit version of either RHEL 8 or RHEL 9.
If pass is not installed, or it can't be installed, you must enable CodeReady Linux Builder (CRB) repository and Extra Packages for Enterprise Linux (EPEL).
{{< tabs group="os_version" >}} {{< tab name="RHEL 9" >}}
$ 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" >}}
$ 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 >}}
For a GNOME desktop environment you must install AppIndicator and KStatusNotifierItem GNOME extensions. You must also enable EPEL.
{{< tabs group="os_version" >}} {{< tab name="RHEL 9" >}}
$ # enable EPEL as described above
$ sudo dnf install gnome-shell-extension-appindicator
$ sudo gnome-extensions enable [email protected]
{{< /tab >}} {{< tab name="RHEL 8" >}}
$ # 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 [email protected]
{{< /tab >}} {{< /tabs >}}
If you're not using GNOME, you must install gnome-terminal to enable terminal access from Docker Desktop:
$ sudo dnf install gnome-terminal
To install Docker Desktop on RHEL:
Set up Docker's package repository as follows:
$ sudo dnf config-manager --add-repo {{% param "download-url-base" %}}/docker-ce.repo
Download the latest RPM package.
Install the package with dnf as follows:
$ sudo dnf install ./docker-desktop-x86_64-rhel.rpm
The RPM package includes a post-install script that completes additional setup steps automatically.
The post-install script:
/etc/hosts./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./usr/libexec/qemu-kvm to /usr/local/bin/qemu-system-x86_64.{{% include "desktop-linux-launch.md" %}}
[!TIP]
To attach Red Hat subscription data to containers, see Red Hat verified solution.
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
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:
$ sudo dnf remove docker-desktop
$ sudo dnf install ./docker-desktop-<arch>-rhel.rpm