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

100 lines
3.9 KiB
Markdown

---
description: Instructions for installing Docker EE 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 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](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 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](/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 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 CE to Docker EE, remove the Docker CE 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 EE
{% include ee-linux-install-reuse.md section="yum-uninstall" %}
## Next steps
{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %}