{ { % restricted title="Early Access" \%}} Docker Desktop on RHEL is in Early Access. { { % /restricted \%}}

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.

Prerequisites#

To install Docker Desktop successfully, you must:

If you don't have pass 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 > } }

Additionally, 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 > } }

For non-GNOME desktop environments, gnome-terminal must be installed:

$ 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

  1. Download the latest RPM package.

  2. Install the package with dnf as follows:

console $ sudo dnf install ./docker-desktop-<arch>-rhel.rpm

Don't forget to substitute <arch> with the architecture you want.

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.

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

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:

$ sudo dnf remove docker-desktop
$ sudo dnf install ./docker-desktop-<arch>-rhel.rpm

Next steps#