diff --git a/content/desktop/install/fedora.md b/content/desktop/install/fedora.md index b641be6b85..b24da8f0ab 100644 --- 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--.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. \ No newline at end of file +- 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 index 0a4f818fc0..73bf2e8ed5 100644 --- 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. - - [Install on Debian](debian.md) - - [Install on Fedora](fedora.md) +1. Download the correct package for your Linux distribution and install it with the corresponding package manager. - [Install on Ubuntu](ubuntu.md) - - [Install on Arch](archlinux.md) - By default, Docker Desktop is installed at `/opt/docker-desktop`. + - [Install on Debian](debian.md) + - [Install on Red Hat Enterprise Linux (RHEL)](rhel.md) + - [Install on Fedora](fedora.md) + - [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 new file mode 100644 index 0000000000..6ec707c27a --- /dev/null +++ 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---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---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 index 014278c1b4..be26ec2ca3 100644 --- a/data/toc.yaml +++ b/data/toc.yaml @@ -1099,12 +1099,14 @@ Manuals: title: Install on Linux - sectiontitle: Installation per Linux distro section: - - path: /desktop/install/debian/ - title: Install on Debian - - path: /desktop/install/fedora/ - title: Install on Fedora - 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/archlinux/ title: Install on Arch - path: /desktop/get-started/