mirror of https://github.com/docker/docs.git
Add RHEL docs (#19444)
This commit is contained in:
Dorin-Andrei Geman
GitHub
parent
ad1523ac51
commit
bfa5ef2623
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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**.
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
@ -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/
|
||||
|
|
|
|||
Loading…
Reference in New Issue