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

118 lines
4.1 KiB
Markdown

---
description: Instructions for installing Docker Engine - Enterprise on CentOS
keywords: requirements, apt, installation, centos, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/centos/
- /engine/installation/linux/docker-ee/centos/
title: Get Docker Engine - Enterprise 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 Engine -
Enterprise. 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 Engine - Enterprise repo at [Docker Hub](https://hub.docker.com/my-content){: target="_blank" class="_" }.
- Uninstall old versions of Docker.
- Remove old Docker repos from `/etc/yum.repos.d/`.
### Architectures and storage drivers
Docker Engine - Enterprise supports {{ linux-dist-long }} 64-bit, latest
version, running on `x86_64`.
On {{ linux-dist-long }}, Docker Engine - Enterprise supports storage drivers,
`overlay2` and `devicemapper`. In Docker Engine - Enterprise 17.06.2-ee-5 and
higher, `overlay2` is the recommended storage driver. The following limitations
apply:
- [OverlayFS](/storage/storagedriver/overlayfs-driver){: 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](/storage/storagedriver/device-mapper-driver/){: 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](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }.
### Find your Docker Engine - Enterprise repo URL
{% include ee-linux-install-reuse.md section="find-ee-repo-url" %}
### Uninstall old Docker versions
The Docker Engine - Enterprise 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 Engine - Enterprise, remove the Docker
Engine - Community package as well.
```bash
$ 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 Engine - Enterprise
{% include ee-linux-install-reuse.md section="yum-uninstall" %}
## Next steps
{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %}