docs/engine/installation/linux/docker-ee/rhel.md

description	keywords	redirect_from	title	toc_max
Instructions for installing Docker EE on RHEL	requirements, installation, rhel, rpm, install, uninstall, upgrade, update	/engine/installation/rhel/ /installation/rhel/ /engine/installation/linux/rhel/	Get Docker EE for Red Hat Enterprise Linux	4

{% assign linux-dist = "rhel" %} {% assign linux-dist-url-slug = "rhel" %} {% assign linux-dist-long = "Red Hat Enterprise Linux" %} {% assign package-format = "RPM" %} {% assign gpg-fingerprint = "77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9" %}

{% include ee-linux-install-reuse.md section="ee-install-intro" %}

Prerequisites

Docker Community Edition (Docker CE) is not supported on {{ linux-dist-long }}.

Docker EE repository URL

{% include ee-linux-install-reuse.md section="ee-url-intro" %}

OS requirements

To install Docker EE, you need the 64-bit version of {{ linux-dist-long }} running on x86_64, s390x (IBM Z), or ppc64le (IBM Power) architectures.

In addition, you must use the overlay2 or devicemapper storage driver. The overlay2 driver is preferred for ease of configuration, if you are able to use it. The following limitations apply:

OverlayFS:

• The overlay2 storage driver is only supported on RHEL 7.2 or higher.
• If selinux is enabled, the overlay2 storage driver is only supported on RHEL 7.4 or higher.

Devicemapper:

• On production systems using devicemapper, you must use direct-lvm mode, which requires one or more dedicated block devices. Fast storage such as solid-state media (SSD) is recommended.

{% capture selinux-warning %}

Warning: There is currently no support for selinux on IBM Z systems. If you try to install Docker EE on an IBM Z system with selinux enabled, you get an error about the container-selinux package, which is missing from Red Hat's repository for IBM Z. The only current workaround is to disable selinux before installing or upgrading Docker on IBM Z. {:.warning} {% endcapture %} {{ selinux-warning }}

Uninstall old versions

Older versions of Docker were called docker or docker-engine. If these are installed, uninstall them, along with associated dependencies.

$ sudo yum remove docker \
                  docker-common \
                  docker-selinux \
                  docker-engine-selinux \
                  docker-engine

It's OK if yum reports that none of these packages are installed.

The contents of /var/lib/docker/, including images, containers, volumes, and networks, are preserved. The Docker EE package is now called docker-ee.

Install Docker EE

{% include ee-linux-install-reuse.md section="ways-to-install" %}

Install using the repository

Before you install Docker EE for the first time on a new host machine, you need to set up the Docker repository. Afterward, you can install and update Docker EE from the repository.

Set up the repository

{% include ee-linux-install-reuse.md section="set-up-yum-repo" %}

Install Docker EE

{{ selinux-warning }}

{% include ee-linux-install-reuse.md section="install-using-yum-repo" %}

Upgrade Docker EE

{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %}

Install from a package

{{ selinux-warning }}

{% include ee-linux-install-reuse.md section="install-using-yum-package" %}

Upgrade Docker EE

{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %}

Uninstall Docker EE

{% include ee-linux-install-reuse.md section="yum-uninstall" %}

Next steps

{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %}