docs/install/linux/docker-ee/centos.md

3.9 KiB

description keywords redirect_from title
Instructions for installing Docker EE on CentOS requirements, apt, installation, centos, rpm, install, uninstall, upgrade, update
/engine/installation/centos/
/engine/installation/linux/docker-ee/centos/
Get Docker EE for CentOS

{% assign linux-dist = "centos" %} {% assign linux-dist-cap = "CentOS" %} {% assign linux-dist-url-slug = "centos" %} {% assign linux-dist-long = "Centos" %} {% 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

This section lists what you need to consider before installing Docker EE. Items that require action are explained below.

  • Use {{ linux-dist-cap }} 64-bit 7.1 and higher on x86_64.
  • Use storage driver overlay2 or devicemapper (direct-lvm mode in production).
  • Find the URL for your Docker EE repo at Docker Hub{: target="blank" class="" }.
  • Uninstall old versions of Docker.
  • Remove old Docker repos from /etc/yum.repos.d/.

Architectures and storage drivers

Docker EE supports {{ linux-dist-long }} 64-bit, latest version, running on x86_64.

On {{ linux-dist-long }}, Docker EE supports storage drivers, overlay2 and devicemapper. In Docker EE 17.06.2-ee-5 and higher, overlay2 is the recommended storage driver. The following limitations apply:

  • OverlayFS{: target="blank" class="" }: If selinux is enabled, the overlay2 storage driver is supported on {{ linux-dist-cap }} 7.4 or higher. If selinux is disabled, overlay2 is supported on {{ linux-dist-cap }} 7.2 or higher with kernel version 3.10.0-693 and higher.

  • Device Mapper{: target="blank" class="" }: 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. Do not start Docker until properly configured per the storage guide{: target="blank" class="" }.

Find your Docker EE repo URL

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

Uninstall old Docker versions

The Docker EE package is called docker-ee. Older versions were called docker or docker-engine. Uninstall all older versions and associated dependencies. The contents of /var/lib/docker/ are preserved, including images, containers, volumes, and networks. If you are upgrading from Docker Engine - Community to Docker EE, remove the Docker Engine - Community package as well.

$ sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-selinux \
                  docker-engine-selinux \
                  docker-engine

Repo install and upgrade

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

Set up the repository

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

Install from the repository

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

Upgrade from the repository

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

Package install and upgrade

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

Install with a package

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

Upgrade with a package

{% 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" %}