docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Separate out Docker CE and EE for Linux

This commit is contained in:
Misty Stanley-Jones 2017-05-19 16:42:27 -07:00 committed by Misty Stanley-Jones
parent 6a82b21332
commit 322213052e
20 changed files with 1287 additions and 1245 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
_data/toc.yaml
View File

@ -22,6 +22,38 @@ guides:
section:
- path: /engine/installation/
title: Install Docker
- sectiontitle: Docker EE
section:
- path: /engine/installation/windows/docker-ee/
title: Windows Server
- path: /engine/installation/linux/docker-ee/ubuntu/
title: Ubuntu
- path: /engine/installation/linux/docker-ee/rhel/
title: RHEL
- path: /engine/installation/linux/docker-ee/centos/
title: CentOS
- path: /engine/installation/linux/docker-ee/oracle/
title: Oracle Linux
- path: /engine/installation/linux/docker-ee/suse/
title: SLES
- sectiontitle: Docker CE
section:
- path: /docker-for-mac/install/
title: Mac
- path: /docker-for-windows/install/
title: Windows
- path: /engine/installation/linux/docker-ce/ubuntu/
title: Ubuntu
- path: /engine/installation/linux/docker-ce/debian/
title: Debian
- path: /engine/installation/linux/docker-ce/centos/
title: CentOS
- path: /engine/installation/linux/docker-ce/fedora/
title: Fedora
- path: /engine/installation/linux/docker-ce/binaries/
title: Binaries
- path: /engine/installation/linux/linux-postinstall/
title: Optional Linux post-installation steps
- sectiontitle: Docker Edge
section:
- path: /edge/
@ -31,34 +63,6 @@ guides:
nosync: true
- path: /engine/userguide/eng-image/multistage-build/
title: Use multi-stage builds (Edge only)
- path: /docker-for-mac/install/
title: Docker for Mac
- path: /docker-for-windows/install/
title: Docker for Windows
- path: /docker-ee-for-windows/install/
title: Docker EE for Windows Server
- sectiontitle: Docker for Linux
section:
- path: /engine/installation/linux/ubuntu/
title: Ubuntu
- path: /engine/installation/linux/rhel/
title: Red Hat Enterprise Linux
- path: /engine/installation/linux/centos/
title: CentOS
- path: /engine/installation/linux/fedora/
title: Fedora
- path: /engine/installation/linux/debian/
title: Debian
- path: /engine/installation/linux/oracle/
title: Oracle Linux
- path: /engine/installation/linux/suse/
title: SuSE Linux Enterprise
- path: /engine/installation/linux/other/
title: Other Linux distributions
- path: /engine/installation/binaries/
title: Installation from binaries
- path: /engine/installation/linux/linux-postinstall/
title: Optional post-installation steps
- sectiontitle: Docker for AWS
section:
- path: /docker-for-aws/why/

30
_includes/docker_platform_matrix.md
View File

@ -1,16 +1,16 @@
{% assign green-check = '![yes](/engine/installation/images/green-check.svg){: style="height: 14px; margin: 0 auto"}' %}
| Platform | Docker CE x86_64 | Docker CE ARM | Docker EE |
|:-------------------------------------------------------------------|:------------------|:------------------|:------------------|
| [Ubuntu](/engine/installation/linux/ubuntu.md) | {{ green-check }} | {{ green-check }} | {{ green-check }} |
| [Debian](/engine/installation/linux/debian.md) | {{ green-check }} | {{ green-check }} | |
| [Red Hat Enterprise Linux](/engine/installation/linux/rhel.md) | | | {{ green-check }} |
| [CentOS](/engine/installation/linux/centos.md) | {{ green-check }} | | {{ green-check }} |
| [Fedora](/engine/installation/linux/fedora.md) | {{ green-check }} | | |
| [Oracle Linux](/engine/installation/linux/oracle.md) | | | {{ green-check }} |
| [SUSE Linux Enterprise Server](/engine/installation/linux/suse.md) | | | {{ green-check }} |
| [Microsoft Windows Server 2016](/docker-ee-for-windows/install/) | | | {{ green-check }} |
| [Microsoft Windows 10](/docker-for-windows/) | {{ green-check }} | | |
| [macOS](/docker-for-mac/) | {{ green-check }} | | |
| [Microsoft Azure](/docker-for-azure/) | {{ green-check }} | | {{ green-check }} |
| [Amazon Web Services](/docker-for-aws/) | {{ green-check }} | | {{ green-check }} |
{% assign install-prefix = '/engine/installation/linux' %}
| Platform | Docker CE x86_64 | Docker CE ARM | Docker EE |
|:----------------------------------------------------------------------|:-------------------------------------------------------------|:--------------------------------------------------------------|:-------------------------------------------------------------|
| [Ubuntu]({{ install-prefix }}/ubuntu.md) | [{{ green-check }}]({{ install-prefix }}/docker-ce/ubuntu.md)| [{{ green-check }}]({{ install-prefix }}/docker-ce/ubuntu.md) | [{{ green-check }}]({{ install-prefix }}/docker-ee/ubuntu.md)|
| [Debian]({{ install-prefix }}/docker-ce/debian.md) | [{{ green-check }}]({{ install-prefix }}/docker-ce/debian.md)| [{{ green-check }}]({{ install-prefix }}/docker-ce/debian.md) | |
| [Red Hat Enterprise Linux]({{ install-prefix }}/docker-ee/rhel.md) | | | [{{ green-check }}]({{ install-prefix }}/docker-ee/rhel.md) |
| [CentOS]({{ install-prefix }}/centos.md) | [{{ green-check }}]({{ install-prefix }}/docker-ce/centos.md)| | [{{ green-check }}]({{ install-prefix }}/docker-ee/centos.md)|
| [Fedora]({{ install-prefix }}/docker-ce/fedora.md) | [{{ green-check }}]({{ install-prefix }}/docker-ce/fedora.md)| | |
| [Oracle Linux]({{ install-prefix }}/docker-ee/oracle.md) | | | [{{ green-check }}]({{ install-prefix }}/docker-ee/oracle.md)|
| [SUSE Linux Enterprise Server]({{ install-prefix }}/docker-ee/suse.md)| | | [{{ green-check }}]({{ install-prefix }}/docker-ee/suse.md) |
| [Microsoft Windows Server 2016](/docker-ee-for-windows/install/) | | | [{{ green-check }}](/docker-ee-for-windows/install/) |
| [Microsoft Windows 10](/docker-for-windows/) | [{{ green-check }}](/docker-for-windows/) | | |
| [macOS](/docker-for-mac/) | [{{ green-check }}](/docker-for-mac/) | | |
| [Microsoft Azure](/docker-for-azure/) | [{{ green-check }}](/docker-for-azure/) | | [{{ green-check }}](/docker-for-azure/) |
| [Amazon Web Services](/docker-for-aws/) | [{{ green-check }}](/docker-for-aws/) | | [{{ green-check }}](/docker-for-aws/) |

4
engine/installation/index.md
View File

@ -6,6 +6,10 @@ redirect_from:
- /engine/installation/linux/
- /engine/installation/linux/frugalware/
- /engine/installation/frugalware/
- /engine/installation/linux/other/
- /engine/installation/linux/archlinux/
- /engine/installation/linux/cruxlinux/
- /engine/installation/linux/gentoolinux/
title: Install Docker
---

101
engine/installation/linux/archlinux.md
View File

@ -1,101 +0,0 @@
---
description: Installation instructions for Docker on ArchLinux.
keywords: arch linux, docker, documentation, installation
redirect_from:
- /engine/installation/archlinux/
title: Install Docker on Arch Linux
---
Installing on Arch Linux can be handled via the package in community:
- [docker](https://www.archlinux.org/packages/community/x86_64/docker/)
or the following AUR package:
- [docker-git](https://aur.archlinux.org/packages/docker-git/)
The docker package will install the latest tagged version of docker. The
docker-git package will build from the current master branch.
## Dependencies
Docker depends on several packages which are specified as dependencies
in the packages. The core dependencies are:
- bridge-utils
- device-mapper
- iproute2
- sqlite
## Installation
For the normal package a simple
$ sudo pacman -S docker
is all that is needed.
For the AUR package execute:
$ yaourt -S docker-git
The instructions here assume **yaourt** is installed. See [Arch User
Repository](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages)
for information on building and installing packages from the AUR if you
have not done so before.
## Starting Docker
There is a systemd service unit created for docker. To start the docker
service:
$ sudo systemctl start docker
To start on system boot:
$ sudo systemctl enable docker
## Custom daemon options
If you need to add an HTTP Proxy, set a different directory or partition for the
Docker runtime files, or make other customizations, read our systemd article to
learn how to [customize your systemd Docker daemon options](../../admin/systemd.md).
## Running Docker with a manually-defined network
If you manually configure your network using `systemd-network` version 220 or
higher, containers you start with Docker may be unable to access your network.
Beginning with version 220, the forwarding setting for a given network
(`net.ipv4.conf.<interface>.forwarding`) defaults to *off*. This setting
prevents IP forwarding. It also conflicts with Docker which enables the
`net.ipv4.conf.all.forwarding` setting within a container.
To work around this, edit the `<interface>.network` file in
`/etc/systemd/network/` on your Docker host add the following block:
```
[Network]
...
IPForward=kernel
...
```
This configuration allows IP forwarding from the container as expected.
## Uninstallation
To uninstall the Docker package:
$ sudo pacman -R docker
To uninstall the Docker package and dependencies that are no longer needed:
$ sudo pacman -Rns docker
The above commands will not remove images, containers, volumes, or user created
configuration files on your host. If you wish to delete all images, containers,
and volumes run the following command:
$ rm -rf /var/lib/docker
You must delete the user created configuration files manually.

366
engine/installation/linux/centos.md
View File

@ -1,364 +1,10 @@
---
description: Instructions for installing Docker on CentOS
keywords: Docker, Docker documentation, requirements, apt, installation, centos, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/centos/
title: Get Docker for CentOS
description: CentOS installation landing page
title: Choose Docker CE or Docker EE on CentOS
---
{% assign minor-version = "17.03" %}
The instructions for installing Docker on CentOS depend on whether you are using
Docker EE or Docker CE.
To get started with Docker on CentOS, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
## Prerequisites
### Docker EE customers
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
repository URL associated with your trial or subscription. To get this information:
- Go to [https://store.docker.com/?overlay=subscriptions](https://store.docker.com/?overlay=subscriptions).
- Choose **Get Details** / **Setup Instructions** within the
**Docker Enterprise Edition for CentOS** section.
- Copy the URL from the field labeled
**Copy and paste this URL to download your Edition**.
Where the installation instructions differ for Docker EE and Docker CE, use this
URL when you see the placeholder text `<DOCKER-EE-URL>`.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
In addition, you must use the `devicemapper` storage driver if you use Docker EE
or CS-Engine. On production systems, you must use `direct-lvm` mode, which
requires one or more dedicated block devices. Fast storage such as solid-state
media (SSD) is recommended.
### OS requirements
To install Docker, you need the 64-bit version of CentOS 7.
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them, along with associated dependencies.
```bash
$ sudo yum remove docker \
docker-common \
container-selinux \
docker-selinux \
docker-engine \
docker-engine-selinux
```
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 CE package is now called `docker-ce`, and
the Docker EE package is now called `docker-ee`.
## Install Docker
You can install Docker in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.
- Some users download the RPM package and install it manually and manage
upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet.
### Install using the repository
Before you install Docker for the first time on a new host machine, you need to
set up the Docker repository. Afterward, you can install and update Docker from
the repository.
#### Set up the repository
Repository set-up instructions are different for [Docker CE](#docker-ce) and
[Docker EE](#docker-ee).
##### Docker CE
{% assign download-url-base = "https://download.docker.com/linux/centos" %}
1. Install required packages. `yum-utils` provides the `yum-config-manager`
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
`devicemapper` storage driver.
```bash
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
```
2. Enable the `extras` CentOS repository. This ensures access to the
`container-selinux` package which is required by `docker-ce`.
```bash
$ sudo yum-config-manager --enable extras
```
3. Use the following command to set up the **stable** repository. You always
need the **stable** repository, even if you want to install **edge** builds
as well.
```bash
$ sudo yum-config-manager \
--add-repo \
{{ download-url-base }}/docker-ce.repo
```
4. **Optional**: Enable the **edge** repository. This repository is included
in the `docker.repo` file above but is disabled by default. You can enable
it alongside the stable repository.
```bash
$ sudo yum-config-manager --enable docker-ce-edge
```
You can disable the **edge** repository by running the `yum-config-manager`
command with the `--disable` flag. To re-enable it, use the
`--enable` flag. The following command disables the **edge** repository.
```bash
$ sudo yum-config-manager --disable docker-ce-edge
```
[Learn about **stable** and **edge** builds](/engine/installation/).
##### Docker EE
1. Remove any existing Docker repositories from `/etc/yum.repos.d/`.
2. Store your Docker EE repository URL in a `yum` variable in `/etc/yum/vars/`.
Replace `<DOCKER-EE-URL>` with the URL you noted down in the
[prerequisites](#prerequisites).
```bash
$ sudo sh -c 'echo "<DOCKER-EE-URL>" > /etc/yum/vars/dockerurl'
```
3. Enable the `extras` CentOS repository. This ensures access to the
`container-selinux` package which is required by `docker-ee`.
```bash
$ sudo yum-config-manager --enable extras
```
4. Install required packages. `yum-utils` provides the `yum-config-manager`
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
`devicemapper` storage driver.
```bash
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
```
5. Use the following command to add the **stable** repository:
```bash
$ sudo yum-config-manager \
--add-repo \
<DOCKER-EE-URL>/docker-ee.repo
```
#### Install Docker
1. Update the `yum` package index.
```bash
$ sudo yum makecache fast
```
If this is the first time you have refreshed the package index since adding
the Docker repositories, you will be prompted to accept the GPG key, and
the key's fingerprint will be shown. Verify that the fingerprint is
correct, and if so, accept the key.
| Docker Edition | Fingerprint |
|----------------|------------------------------------------------------|
| Docker CE | `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35` |
| Docker EE | `DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96` |
2. Install the latest version of Docker, or go to the next step to install a
specific version.
| Docker Edition | Command |
|----------------|-------------------------------------|
| Docker CE | `sudo yum install docker-ce` |
| Docker EE | `sudo yum install docker-ee` |
> **Warning**:
> If you have multiple Docker repositories enabled, installing
> or updating without specifying a version in the `yum install` or
> `yum update` command will always install the highest possible version,
> which may not be appropriate for your stability needs.
{:.warning}
3. On production systems, you should install a specific version of Docker
instead of always using the latest. List the available versions. This
example uses the `sort -r` command to sort the results by version number,
highest to lowest, and is truncated.
> **Note**: This `yum list` command only shows binary packages. To show
> source packages as well, omit the `.x86_64` from the package name.
```bash
$ yum list docker-ce.x86_64 --showduplicates |sort -r
docker-ce.x86_64 {{ minor-version }}.0.el7 docker-ce-stable
```
The contents of the list depend upon which repositories are enabled, and
will be specific to your version of CentOS (indicated by the `.el7` suffix
on the version, in this example). Choose a specific version to install. The
second column is the version string. The third column is the repository
name, which indicates which repository the package is from and by extension
its stability level. To install a specific version, append the version
string to the package name and separate them by a hyphen (`-`):
| Docker Edition | Command |
|----------------|-----------------------------------------------|
| Docker CE | `sudo yum install docker-ce-<VERSION>` |
| Docker EE | `sudo yum install docker-ee-<VERSION>` |
4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
that the file was empty, add the following contents.
```json
{
"storage-driver": "devicemapper"
}
```
5. For production systems, you must use `direct-lvm` mode, which requires you
to prepare the block devices. Follow the procedure in the
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
**before starting Docker**.
6. Start Docker.
```bash
$ sudo systemctl start docker
```
7. Verify that `docker` is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Linux postinstall](linux-postinstall.md) to allow non-privileged
users to run Docker commands and for other optional configuration steps.
#### Upgrade Docker
To upgrade Docker, first run `sudo yum makecache fast`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
### Install from a package
If you cannot use Docker's repository to install Docker, you can download the
`.rpm` file for your release and install it manually. You will need to download
a new file each time you want to upgrade Docker.
1. This step is different for Docker CE and Docker EE.
- **Docker CE**: Go to
[{{ download-url-base }}/7/x86_64/stable/Packages/]({{ download-url-base }}/7/x86_64/stable/Packages/)
and download the `.rpm` file for the Docker version you want to install.
> **Note**: To install an **edge** package, change the word
> `stable` in the > URL to `edge`.
> [Learn about **stable** and **edge** channels](/engine/installation/).
- **Docker EE**: Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Go to
`7/x86_64/stable-{{ minor-version }}/Packages/` and download the `.rpm`
file for the Docker version you want to install.
2. Install Docker, changing the path below to the path where you downloaded
the Docker package.
```bash
$ sudo yum install /path/to/package.rpm
```
3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
that the file was empty, add the following contents.
```json
{
"storage-driver": "devicemapper"
}
```
4. For production systems, you must use `direct-lvm` mode, which requires you
to prepare the block devices. Follow the procedure in the
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
**before starting Docker**.
5. Start Docker.
```bash
$ sudo systemctl start docker
```
6. Verify that `docker` is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker
To upgrade Docker, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `yum -y upgrade`
instead of `yum -y install`, and pointing to the new file.
## Uninstall Docker
1. Uninstall the Docker package:
| Docker Edition | Command |
|----------------|--------------------------------|
| Docker CE | `sudo yum remove docker-ce` |
| Docker EE | `sudo yum remove docker-ee` |
2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and
volumes:
```bash
$ sudo rm -rf /var/lib/docker
```
3. If desired, remove the `devicemapper` thin pool and reformat the block
devices that were part of it.
You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).
- [Install Docker EE on CentOS](/engine/installation/linux/docker-ee/centos.md)
- [Install Docker CE on CentOS](/engine/installation/linux/docker-ce/centos.md)

87
engine/installation/linux/cruxlinux.md
View File

@ -1,87 +0,0 @@
---
description: Docker installation on CRUX Linux.
keywords: crux linux, Docker, documentation, installation
redirect_from:
- /engine/installation/cruxlinux/
title: Install Docker on CRUX Linux
---
Installing on CRUX Linux can be done using the
official [contrib](http://crux.nu/portdb/?a=repo&q=contrib) ports:
- docker
The `docker` port will build and install the latest tagged version of Docker.
## Installation
Assuming you have contrib enabled, update your ports tree and install docker:
$ sudo prt-get depinst docker
## Kernel requirements
To have a working **CRUX+Docker** Host you must ensure your Kernel has
the necessary modules enabled for the Docker Daemon to function correctly.
Please read the `README`:
$ sudo prt-get readme docker
The `docker` port installs the `contrib/check-config.sh` script
provided by the Docker contributors for checking your kernel
configuration as a suitable Docker host.
To check your Kernel configuration run:
$ /usr/share/docker/check-config.sh
## Starting Docker
There is a rc script created for Docker. To start the Docker service:
$ sudo /etc/rc.d/docker start
To start on system boot:
- Edit `/etc/rc.conf`
- Put `docker` into the `SERVICES=(...)` array after `net`.
## Images
There is a CRUX image as part of the Docker "Official Library" of images.
To use this image simply pull it or use it as part of your `FROM` line in
your `Dockerfile(s)`.
$ docker pull crux
$ docker run -i -t crux
There are also user contributed [CRUX based image(s)](https://hub.docker.com/_/crux/) on the Docker Hub.
## Uninstallation
To uninstall the Docker package:
$ sudo prt-get remove docker
The above command will not remove images, containers, volumes, or user created
configuration files on your host. If you wish to delete all images, containers,
and volumes run the following command:
$ rm -rf /var/lib/docker
You must delete the user created configuration files manually.
## Issues
If you have any issues please file a bug with the
[CRUX Bug Tracker](http://crux.nu/bugs/).
## Support
For support contact the [CRUX Mailing List](http://crux.nu/Main/MailingLists)
or join CRUX's [IRC Channels](http://crux.nu/Main/IrcChannels). on the
[FreeNode](http://freenode.net/) IRC Network.

4
engine/installation/binaries.md → engine/installation/linux/docker-ce/binaries.md
View File

@ -1,7 +1,9 @@
---
description: Instructions for installing Docker as a binary. Mostly meant for hackers who want to try out Docker on a variety of environments.
keywords: binaries, installation, docker, documentation, linux
title: Install Docker from binaries
title: Install Docker CE from binaries
redirect_from:
- /engine/installation/binaries/
---
> **Note**: You may have been redirected to this page because there is no longer

256
engine/installation/linux/docker-ce/centos.md Normal file
View File

@ -0,0 +1,256 @@
---
description: Instructions for installing Docker CE on CentOS
keywords: requirements, apt, installation, centos, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/centos/
title: Get Docker CE for CentOS
---
{% assign minor-version = "17.03" %}
To get started with Docker CE on CentOS, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
## Prerequisites
### Docker EE customers
To install Docker Enterprise Edition (Docker EE), go to
[Get Docker EE for Ubuntu](/engine/installation/linux/docker-ee/centos/)
**instead of this topic**.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
### OS requirements
To install Docker CE, you need the 64-bit version of CentOS 7.
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them, along with associated dependencies.
```bash
$ sudo yum remove docker \
docker-common \
container-selinux \
docker-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 CE package is now called `docker-ce`.
## Install Docker CE
You can install Docker CE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.
- Some users download the RPM package and install it manually and manage
upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet.
### Install using the repository
Before you install Docker CE for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker
from the repository.
#### Set up the repository
{% assign download-url-base = "https://download.docker.com/linux/centos" %}
1. Install required packages. `yum-utils` provides the `yum-config-manager`
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
`devicemapper` storage driver.
```bash
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
```
2. Use the following command to set up the **stable** repository. You always
need the **stable** repository, even if you want to install **edge** builds
as well.
```bash
$ sudo yum-config-manager \
--add-repo \
{{ download-url-base }}/docker-ce.repo
```
3. **Optional**: Enable the **edge** repository. This repository is included
in the `docker.repo` file above but is disabled by default. You can enable
it alongside the stable repository.
```bash
$ sudo yum-config-manager --enable docker-ce-edge
```
You can disable the **edge** repository by running the `yum-config-manager`
command with the `--disable` flag. To re-enable it, use the
`--enable` flag. The following command disables the **edge** repository.
```bash
$ sudo yum-config-manager --disable docker-ce-edge
```
[Learn about **stable** and **edge** builds](/engine/installation/).
#### Install Docker CE
1. Update the `yum` package index.
```bash
$ sudo yum makecache fast
```
If this is the first time you have refreshed the package index since adding
the Docker repositories, you will be prompted to accept the GPG key, and
the key's fingerprint will be shown. Verify that the fingerprint is
correct, and if so, accept the key. The fingerprint should match
`060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`.
2. Install the latest version of Docker CE, or go to the next step to install a
specific version.
```bash
$ sudo yum install docker-ce
```
> **Warning**: If you have multiple Docker repositories enabled, installing
> or updating without specifying a version in the `yum install` or
> `yum update` command will always install the highest possible version,
> which may not be appropriate for your stability needs.
3. On production systems, you should install a specific version of Docker CE
instead of always using the latest. List the available versions. This
example uses the `sort -r` command to sort the results by version number,
highest to lowest, and is truncated.
> **Note**: This `yum list` command only shows binary packages. To show
> source packages as well, omit the `.x86_64` from the package name.
```bash
$ yum list docker-ce.x86_64 --showduplicates | sort -r
docker-ce.x86_64 {{ minor-version }}.0.el7 docker-ce-stable
```
The contents of the list depend upon which repositories are enabled, and
will be specific to your version of CentOS (indicated by the `.el7` suffix
on the version, in this example). Choose a specific version to install. The
second column is the version string. The third column is the repository
name, which indicates which repository the package is from and by extension
its stability level. To install a specific version, append the version
string to the package name and separate them by a hyphen (`-`):
```bash
$ sudo yum install docker-ce-<VERSION>
```
4. Start Docker.
```bash
$ sudo systemctl start docker
```
5. Verify that `docker` is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker CE is installed and running. You need to use `sudo` to run Docker
commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker CE
To upgrade Docker CE, first run `sudo yum makecache fast`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
### Install from a package
If you cannot use Docker's repository to install Docker, you can download the
`.rpm` file for your release and install it manually. You will need to download
a new file each time you want to upgrade Docker.
1. Go to
[{{ download-url-base }}/7/x86_64/stable/Packages/]({{ download-url-base }}/7/x86_64/stable/Packages/)
and download the `.rpm` file for the Docker version you want to install.
> **Note**: To install an **edge** package, change the word
> `stable` in the > URL to `edge`.
> [Learn about **stable** and **edge** channels](/engine/installation/).
2. Install Docker CE, changing the path below to the path where you downloaded
the Docker package.
```bash
$ sudo yum install /path/to/package.rpm
```
3. Start Docker.
```bash
$ sudo systemctl start docker
```
4. Verify that `docker` is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker CE is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker CE
To upgrade Docker CE, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `yum -y upgrade`
instead of `yum -y install`, and pointing to the new file.
## Uninstall Docker CE
1. Uninstall the Docker package:
```bash
$ sudo yum remove docker-ce
```
2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and
volumes:
```bash
$ sudo rm -rf /var/lib/docker
```
You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](/engine/userguide/index.md).

51
engine/installation/linux/debian.md → engine/installation/linux/docker-ce/debian.md
View File

@ -1,15 +1,16 @@
---
description: Instructions for installing Docker on Debian
keywords: Docker, Docker documentation, requirements, apt, installation, debian, install, uninstall, upgrade, update
description: Instructions for installing Docker CE on Debian
keywords: requirements, apt, installation, debian, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/debian/
- /engine/installation/linux/raspbian/
title: Get Docker for Debian
- /engine/installation/linux/debian/
title: Get Docker CE for Debian
---
{% assign minor-version = "17.03" %}
To get started with Docker on Debian, make sure you
To get started with Docker CE on Debian, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
@ -23,7 +24,7 @@ and distributions for different Docker editions, see
### OS requirements
To install Docker, you need the 64-bit version of one of these Debian or
To install Docker CE, you need the 64-bit version of one of these Debian or
Raspbian versions:
- Stretch (testing)
@ -39,7 +40,7 @@ Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them:
```bash
$ sudo apt-get remove docker docker-engine
$ sudo apt-get remove docker docker-engine docker.io
```
It's OK if `apt-get` reports that none of these packages are installed.
@ -166,8 +167,8 @@ from the repository.
#### Install Docker CE
> **NOTE**: On Debian for ARM you can continue following this step. For Raspbian,
scroll down to follow its specific steps.
> **Note**: On Debian for ARM you can continue following this step. For Raspbian,
> scroll down to follow its specific steps.
1. Update the `apt` package index.
@ -175,11 +176,9 @@ from the repository.
$ sudo apt-get update
```
2. Install the latest version of Docker, or go to the next step to install a
2. Install the latest version of Docker CE, or go to the next step to install a
specific version. Any existing installation of Docker is replaced.
Use this command to install the latest version of Docker:
```bash
$ sudo apt-get install docker-ce
```
@ -191,7 +190,7 @@ from the repository.
> which may not be appropriate for your stability needs.
{:.warning}
3. On production systems, you should install a specific version of Docker
3. On production systems, you should install a specific version of Docker CE
instead of always using the latest. This output is truncated. List the
available versions:
@ -240,7 +239,7 @@ steps.
#### Upgrade Docker CE
To upgrade Docker, first run `sudo apt-get update`, then follow the
To upgrade Docker CE, first run `sudo apt-get update`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
@ -271,21 +270,21 @@ installing Docker.
```bash
$ sudo apt-get update
```
2. Install the latest version of Docker, or go to the next step to install a
specific version. Any existing installation of Docker is replaced.
2. Install the latest version of Docker CE, or go to the next step to install a
specific version. Any existing installation of Docker CE is replaced.
Use this command to install the latest version of Docker:
```bash
$ sudo apt-get install docker-engine
```
> **NOTE**: By default, Docker on Raspbian is Docker Community Edition, so
> there is no need to specify docker-ce.
> **Note**: By default, Docker on Raspbian is Docker Community Edition.
> **NOTE**: If `curl -sSL https://get.docker.com | sh` isn't used,
> **Note**: If `curl -sSL https://get.docker.com | sh` isn't used,
> then docker won't have auto-completion! You'll have to add it manually.
3. Verify that Docker is installed correctly by running the `hello-world`
3. Verify that Docker CE is installed correctly by running the `hello-world`
image.
```bash
@ -316,8 +315,8 @@ If you cannot use Docker's repository to install Docker CE, you can download the
a new file each time you want to upgrade Docker.
1. Go to [{{ download-url-base }}/dists/]({{ download-url-base }}/dists/),
choose your Debian version, browse to `stable/pool/stable/`, choose either
`amd64` or `armhf`,and download the `.deb` file for the Docker version you
choose your Debian version, browse to `pool/stable/`, choose either
`amd64` or `armhf`, and download the `.deb` file for the Docker CE version you
want to install and for your version of Debian.
> **Note**: To install an **edge** package, change the word
@ -348,14 +347,14 @@ commands. Continue to [Post-installation steps for Linux](linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional
configuration steps.
#### Upgrade Docker
#### Upgrade Docker CE
To upgrade Docker, download the newer package file and repeat the
[installation procedure](#install-from-a-package), pointing to the new file.
## Uninstall Docker
## Uninstall Docker CE
1. Uninstall the Docker package:
1. Uninstall the Docker CE package:
```bash
$ sudo apt-get purge docker-ce
@ -373,6 +372,6 @@ You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).
- Continue with the [User Guide](/engine/userguide/index.md).

45
engine/installation/linux/fedora.md → engine/installation/linux/docker-ce/fedora.md
View File

@ -1,14 +1,15 @@
---
description: Instructions for installing Docker on Fedora
keywords: Docker, Docker documentation, requirements, apt, installation, fedora, rpm, install, uninstall, upgrade, update
description: Instructions for installing Docker CE on Fedora
keywords: requirements, apt, installation, fedora, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/fedora/
title: Get Docker for Fedora
- /engine/installation/linux/fedora/
title: Get Docker CE for Fedora
---
{% assign minor-version = "17.03" %}
To get started with Docker on Fedora, make sure you
To get started with Docker CE on Fedora, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
@ -60,9 +61,9 @@ You can install Docker CE in different ways, depending on your needs:
### Install using the repository
Before you install Docker for the first time on a new host machine, you need to
set up the Docker repository. Afterward, you can install and update Docker from
the repository.
Before you install Docker CE for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker CE
from the repository.
#### Set up the repository
@ -117,7 +118,7 @@ the repository.
`060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35` and if so, accept the
key.
2. Install the latest version of Docker, or go to the next step to install a
2. Install the latest version of Docker CE, or go to the next step to install a
specific version.
```bash
@ -131,7 +132,7 @@ the repository.
> which may not be appropriate for your stability needs.
{:.warning}
3. On production systems, you should install a specific version of Docker
3. On production systems, you should install a specific version of Docker CE
instead of always using the latest. List the available versions. This
example uses the `sort -r` command to sort the results by version number,
highest to lowest, and is truncated.
@ -140,7 +141,7 @@ the repository.
> source packages as well, omit the `.x86_64` from the package name.
```bash
$ dnf list docker-ce.x86_64 --showduplicates |sort -r
$ dnf list docker-ce.x86_64 --showduplicates | sort -r
docker-ce.x86_64 {{ minor-version }}.0.fc24 docker-ce-stable
```
@ -173,13 +174,15 @@ the repository.
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Linux postinstall](linux-postinstall.md) to allow non-privileged
users to run Docker commands and for other optional configuration steps.
Docker CE is installed and running. You need to use `sudo` to run Docker
commands. Continue to
[Linux postinstall](/engine/installation/linux/linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker CE
To upgrade Docker, first run `sudo dnf makecache fast`, then follow the
To upgrade Docker CE, first run `sudo dnf makecache fast`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
@ -187,7 +190,7 @@ to install.
If you cannot use Docker's repository to install Docker, you can download the
`.rpm` file for your release and install it manually. You will need to download
a new file each time you want to upgrade Docker.
a new file each time you want to upgrade Docker CE.
1. Go to [{{ download-url-base }}/]({{ download-url-base }}/) and choose your
version of Fedora. Go to `x86_64/stable/Packages/`
@ -196,7 +199,7 @@ a new file each time you want to upgrade Docker.
> **Note**: To install an **edge** package, change the word
> `stable` in the URL to `edge`.
2. Install Docker, changing the path below to the path where you downloaded
2. Install Docker CE, changing the path below to the path where you downloaded
the Docker package.
```bash
@ -224,13 +227,13 @@ Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker
#### Upgrade Docker CE
To upgrade Docker, download the newer package file and repeat the
To upgrade Docker CE, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `dnf -y upgrade`
instead of `dnf -y install`, and pointing to the new file.
## Uninstall Docker
## Uninstall Docker CE
1. Uninstall the Docker package:
@ -250,6 +253,6 @@ You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).
- Continue with the [User Guide](/engine/userguide/index.md).

292
engine/installation/linux/docker-ce/ubuntu.md Normal file
View File

@ -0,0 +1,292 @@
---
description: Instructions for installing Docker CE on Ubuntu
keywords: requirements, apt, installation, ubuntu, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/ubuntulinux/
- /installation/ubuntulinux/
- /engine/installation/linux/ubuntulinux/
title: Get Docker CE for Ubuntu
---
{% assign minor-version = "17.03" %}
To get started with Docker CE on Ubuntu, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
## Prerequisites
### Docker EE customers
To install Docker Enterprise Edition (Docker EE), go to
[Get Docker EE for Ubuntu](/engine/installation/linux/docker-ee/ubuntu/)
**instead of this topic**.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
### OS requirements
To install Docker CE, you need the 64-bit version of one of these Ubuntu
versions:
- Yakkety 16.10
- Xenial 16.04 (LTS)
- Trusty 14.04 (LTS)
Docker CE is supported on both `x86_64` and `armhf` architectures.
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them:
```bash
$ sudo apt-get remove docker docker-engine docker.io
```
It's OK if `apt-get` reports that none of these packages are installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker CE package is now called `docker-ce`.
### Recommended extra packages for Trusty 14.04
Unless you have a strong reason not to, install the
`linux-image-extra-*` packages, which allow Docker to use the `aufs` storage
drivers.
```bash
$ sudo apt-get update
$ sudo apt-get install \
linux-image-extra-$(uname -r) \
linux-image-extra-virtual
```
For Ubuntu 16.04 and higher, the Linux kernel includes support for OverlayFS,
and Docker CE will use the `overlay2` storage driver by default.
## Install Docker CE
You can install Docker CE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.
- Some users download the DEB package and install it manually and manage
upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet.
### Install using the repository
Before you install Docker CE for the first time on a new host machine, you need to
set up the Docker repository. Afterward, you can install and update Docker from
the repository.
#### Set up the repository
{% assign download-url-base = "https://download.docker.com/linux/ubuntu" %}
1. Update the `apt` package index:
```bash
$ sudo apt-get update
```
2. Install packages to allow `apt` to use a repository over HTTPS:
```bash
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
```
2. Add Docker's official GPG key:
```bash
$ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add -
```
Verify that the key fingerprint is `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`.
```bash
$ sudo apt-key fingerprint 0EBFCD88
pub 4096R/0EBFCD88 2017-02-22
Key fingerprint = 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
uid Docker Release (CE deb) <docker@docker.com>
sub 4096R/F273FCD8 2017-02-22
```
3. Use the following command to set up the **stable** repository. You always
need the **stable** repository, even if you want to install **edge** builds
as well.
> **Note**: The `lsb_release -cs` sub-command below returns the name of your
> Ubuntu distribution, such as `xenial`.
>
> Sometimes, in a distribution like Linux Mint, you might have to change
> `$(lsb_release -cs)` to your parent Ubuntu distribution. For
> example: If you are using `Linux Mint Rafaela`, you could use
> `trusty`.
**amd64**:
```bash
$ sudo add-apt-repository \
"deb [arch=amd64] {{ download-url-base }} \
$(lsb_release -cs) \
stable"
```
**armhf**:
```bash
$ sudo add-apt-repository \
"deb [arch=armhf] {{ download-url-base }} \
$(lsb_release -cs) \
stable"
```
[Learn about **stable** and **edge** channels](/engine/installation/).
#### Install Docker CE
1. Update the `apt` package index.
```bash
$ sudo apt-get update
```
2. Install the latest version of Docker CE, or go to the next step to install a
specific version. Any existing installation of Docker is replaced.
```bash
$ sudo apt-get install docker-ce
```
> **Warning**:
> If you have multiple Docker repositories enabled, installing
> or updating without specifying a version in the `apt-get install` or
> `apt-get update` command will always install the highest possible version,
> which may not be appropriate for your stability needs.
{:.warning}
3. On production systems, you should install a specific version of Docker CE
instead of always using the latest. This output is truncated. List the
available versions.
```bash
$ apt-cache madison docker-ce
docker-ce | {{ minor-version }}.0~ce-0~ubuntu-xenial | {{ download-url-base }} xenial/stable amd64 Packages
```
The contents of the list depend upon which repositories are enabled,
and will be specific to your version of Ubuntu (indicated by the `xenial`
suffix on the version, in this example). Choose a specific version to
install. The second column is the version string. The third column is the
repository name, which indicates which repository the package is from and
by extension its stability level. To install a specific version, append the
version string to the package name and separate them by an equals sign (`=`):
```bash
$ sudo apt-get install docker-ce=<VERSION>
```
The Docker daemon starts automatically.
4. Verify that Docker CE is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker CE is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Linux postinstall](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker CE
To upgrade Docker CE, first run `sudo apt-get update`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
### Install from a package
If you cannot use Docker's repository to install Docker CE, you can download the
`.deb` file for your release and install it manually. You will need to download
a new file each time you want to upgrade Docker CE.
1. Go to [{{ download-url-base }}/dists/]({{ download-url-base }}/dists/), choose your
Ubuntu version, browse to `pool/stable/`, choose either `amd64` or
`armhf`,and download the `.deb` file for the Docker version you want to
install and for your version of Ubuntu.
> **Note**: To install an **edge** package, change the word
> `stable` in the URL to `edge`.
> [Learn about **stable** and **edge** channels](/engine/installation/).
2. Install Docker CE, changing the path below to the path where you downloaded
the Docker package.
```bash
$ sudo dpkg -i /path/to/package.deb
```
The Docker daemon starts automatically.
3. Verify that Docker CE is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker CE is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker CE
To upgrade Docker CE, download the newer package file and repeat the
[installation procedure](#install-from-a-package), pointing to the new file.
## Uninstall Docker CE
1. Uninstall the Docker CE package:
```bash
$ sudo apt-get purge docker-ce
```
2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and
volumes:
```bash
$ sudo rm -rf /var/lib/docker
```
You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](/engine/userguide/index.md).

289
engine/installation/linux/docker-ee/centos.md Normal file
View File

@ -0,0 +1,289 @@
---
description: Instructions for installing Docker EE on CentOS
keywords: requirements, apt, installation, centos, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/centos/
title: Get Docker EE for CentOS
---
{% assign minor-version = "17.03" %}
To get started with Docker EE on CentOS, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker EE](#install-docker-ee).
## Prerequisites
Docker CE users should go to
[Get docker CE for CentOS](/engine/installatioin/linux/docker-ce/centos.md)
**instead of this topic**.
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
repository URL associated with your trial or subscription. To get this information:
- Go to [https://store.docker.com/?overlay=subscriptions](https://store.docker.com/?overlay=subscriptions).
- Choose **Get Details** / **Setup Instructions** within the
**Docker Enterprise Edition for CentOS** section.
- Copy the URL from the field labeled
**Copy and paste this URL to download your Edition**.
Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
In addition, you must use the `devicemapper` storage driver if you use Docker EE.
On production systems, you must use `direct-lvm` mode, which requires one or
more dedicated block devices. Fast storage such as solid-state media (SSD) is
recommended.
### OS requirements
To install Docker EE, you need the 64-bit version of CentOS 7.
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. In addition,
if you are upgrading from Docker CE to Docker EE, remove the Docker CE package.
```bash
$ sudo yum remove docker \
docker-common \
container-selinux \
docker-selinux \
docker-engine \
docker-ce
```
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
You can install Docker EE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.
- Some users download the RPM package and install it manually and manage
upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet.
### 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 EE repository. Afterward, you can install and update Docker
EE from the repository.
#### Set up the repository
1. Remove any existing Docker repositories from `/etc/yum.repos.d/`.
2. Store your Docker EE repository URL in a `yum` variable in `/etc/yum/vars/`.
Replace `<DOCKER-EE-URL>` with the URL you noted down in the
[prerequisites](#prerequisites).
```bash
$ sudo sh -c 'echo "<DOCKER-EE-URL>" > /etc/yum/vars/dockerurl'
```
3. Install required packages. `yum-utils` provides the `yum-config-manager`
utility, and `device-mapper-persistent-data` and `lvm2` are required by the
`devicemapper` storage driver.
```bash
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
```
4. Use the following command to add the **stable** repository:
```bash
$ sudo yum-config-manager \
--add-repo \
<DOCKER-EE-URL>/docker-ee.repo
```
#### Install Docker EE
1. Update the `yum` package index.
```bash
$ sudo yum makecache fast
```
If this is the first time you have refreshed the package index since adding
the Docker repositories, you will be prompted to accept the GPG key, and
the key's fingerprint will be shown. Verify that the fingerprint is
correct, and if so, accept the key. The fingerprint should match
`DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`.
2. Install the latest version of Docker EE, or go to the next step to install a
specific version.
```bash
$ sudo yum install docker-ee
```
> **Warning**:
> If you have multiple Docker repositories enabled, installing
> or updating without specifying a version in the `yum install` or
> `yum update` command will always install the highest possible version,
> which may not be appropriate for your stability needs.
{:.warning}
3. On production systems, you should install a specific version of Docker EE
instead of always using the latest. List the available versions. This
example uses the `sort -r` command to sort the results by version number,
highest to lowest, and is truncated.
> **Note**: This `yum list` command only shows binary packages. To show
> source packages as well, omit the `.x86_64` from the package name.
```bash
$ yum list docker-ee.x86_64 --showduplicates | sort -r
docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable
```
The contents of the list depend upon which repositories are enabled, and
will be specific to your version of CentOS (indicated by the `.el7` suffix
on the version, in this example). Choose a specific version to install. The
second column is the version string. The third column is the repository
name, which indicates which repository the package is from and by extension
its stability level. To install a specific version, append the version
string to the package name and separate them by a hyphen (`-`):
```bash
$ sudo yum install docker-ee-<VERSION>
```
4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
that the file was empty, add the following contents.
```json
{
"storage-driver": "devicemapper"
}
```
5. For production systems, you must use `direct-lvm` mode, which requires you
to prepare the block devices. Follow the procedure in the
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
**before starting Docker**. Do not skip this step.
6. Start Docker.
```bash
$ sudo systemctl start docker
```
7. Verify that Docker EE is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker EE is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Linux postinstall](/engine/installation/linux/linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional
configuration steps.
#### Upgrade Docker EE
To upgrade Docker EE, first run `sudo yum makecache fast`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
### Install from a package
If you cannot use Docker's repository to install Docker EE, you can download the
`.rpm` file for your release and install it manually. You will need to download
a new file each time you want to upgrade Docker.
1. Go to the Docker EE repository URL associated with your trial or
subscription in your browser. Go to
`7/x86_64/stable-{{ minor-version }}/Packages/` and download the `.rpm`
file for the Docker version you want to install.
2. Install Docker EE, changing the path below to the path where you downloaded
the Docker EE package.
```bash
$ sudo yum install /path/to/package.rpm
```
3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming
that the file was empty, add the following contents.
```json
{
"storage-driver": "devicemapper"
}
```
4. For production systems, you must use `direct-lvm` mode, which requires you
to prepare the block devices. Follow the procedure in the
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
**before starting Docker**. Do not skip this step.
5. Start Docker.
```bash
$ sudo systemctl start docker
```
6. Verify that Docker EE is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker EE is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker EE
To upgrade Docker EE, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `yum -y upgrade`
instead of `yum -y install`, and pointing to the new file.
## Uninstall Docker EE
1. Uninstall the Docker EE package:
```bash
$ sudo yum remove docker-ee
```
2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and
volumes:
```bash
$ sudo rm -rf /var/lib/docker
```
3. If desired, remove the `devicemapper` thin pool and reformat the block
devices that were part of it.
You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](/engine/userguide/index.md).

37
engine/installation/linux/oracle.md → engine/installation/linux/docker-ee/oracle.md
View File

@ -1,17 +1,20 @@
---
description: Instructions for installing Docker on Oracle Linux
keywords: Docker, Docker documentation, requirements, installation, oracle, ol, rpm, install, uninstall, upgrade, update
description: Instructions for installing Docker EE on Oracle Linux
keywords: requirements, installation, oracle, ol, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/oracle/
title: Get Docker for Oracle Linux
- /engine/installation/linux/oracle/
title: Get Docker EE for Oracle Linux
---
To get started with Docker on Oracle Linux, make sure you
To get started with Docker EE on Oracle Linux, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
## Prerequisites
Docker Community Edition (Docker CE) is not supported on Oracle Linux.
### Docker EE repository URL
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
@ -28,16 +31,14 @@ Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
Docker Community Edition (Docker CE) is not supported on Oracle Linux.
### OS requirements
To install Docker EE, you need the 64-bit version of Oracle Linux 7.3 running the
Red Hat Compatible kernel (RHCK) 3.10.0-514 or higher. Older versions of Oracle
Linux are not supported.
In addition, you must use the `devicemapper` storage driver if you use Docker EE
or CS-Engine. On production systems, you must use `direct-lvm` mode, which
In addition, you must use the `devicemapper` storage driver if you use
Docker EE. On production systems, you must use `direct-lvm` mode, which
requires one or more dedicated block devices. Fast storage such as solid-state
media (SSD) is recommended.
@ -59,7 +60,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`.
## Install Docker EE
You can install Docker in different ways, depending on your needs:
You can install Docker EE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
@ -72,9 +73,9 @@ You can install Docker in different ways, depending on your needs:
### Install using the repository
Before you install Docker for the first time on a new host machine, you need to
set up the Docker repository. Afterward, you can install and update Docker from
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
@ -136,7 +137,7 @@ the repository.
{% assign minor-version = "17.03" %}
```bash
$ yum list docker-ee.x86_64 --showduplicates |sort -r
$ yum list docker-ee.x86_64 --showduplicates | sort -r
docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable
```
@ -172,7 +173,7 @@ the repository.
$ sudo systemctl start docker
```
7. Verify that `docker` is installed correctly by running the `hello-world`
7. Verify that Docker EE is installed correctly by running the `hello-world`
image.
```bash
@ -195,9 +196,9 @@ to install.
### Install from a package
If you cannot use the official Docker repository to install Docker, you can
If you cannot use the official Docker repository to install Docker EE, you can
download the `.rpm` file for your release and install it manually. You will
need to download a new file each time you want to upgrade Docker.
need to download a new file each time you want to upgrade Docker EE.
1. Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Browse to
@ -275,6 +276,6 @@ You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).
- Continue with the [User Guide](/engine/userguide/index.md).

40
engine/installation/linux/rhel.md → engine/installation/linux/docker-ee/rhel.md
View File

@ -1,18 +1,21 @@
---
description: Instructions for installing Docker on RHEL
keywords: Docker, Docker documentation, requirements, installation, rhel, rpm, install, uninstall, upgrade, update
description: Instructions for installing Docker EE on RHEL
keywords: requirements, installation, rhel, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/rhel/
- /installation/rhel/
title: Get Docker for Red Hat Enterprise Linux
- /engine/installation/linux/rhel/
title: Get Docker EE for Red Hat Enterprise Linux
---
To get started with Docker on Red Hat Enterprise Linux (RHEL), make sure you
To get started with Docker EE on Red Hat Enterprise Linux (RHEL), make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
## Prerequisites
Docker Community Edition (Docker CE) is not supported on RHEL.
### Docker EE repository URL
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
@ -29,12 +32,9 @@ Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
Docker Community Edition (Docker CE) is not supported on Red Hat Enterprise
Linux.
### OS requirements
To install Docker, you need the 64-bit version of RHEL 7, running on an x86
To install Docker EE, you need the 64-bit version of RHEL 7, running on an x86
hardware platform.
In addition, you must use the `devicemapper` storage driver. On production
@ -61,7 +61,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`.
## Install Docker EE
You can install Docker in different ways, depending on your needs:
You can install Docker EE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
@ -74,9 +74,9 @@ You can install Docker in different ways, depending on your needs:
### Install using the repository
Before you install Docker for the first time on a new host machine, you need to
set up the Docker repository. Afterward, you can install and update Docker from
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
@ -146,7 +146,7 @@ the repository.
<DOCKER-EE-URL>/docker-ee.repo
```
#### Install Docker
#### Install Docker EE
1. Update the `yum` package index.
@ -167,7 +167,7 @@ the repository.
$ sudo yum -y install docker-ee
```
3. On production systems, you should install a specific version of Docker
3. On production systems, you should install a specific version of Docker EE
instead of always using the latest. List the available versions.
This example uses the `sort -r` command to sort the results by version
number, highest to lowest, and is truncated.
@ -178,7 +178,7 @@ the repository.
{% assign minor-version = "17.03" %}
```bash
$ yum list docker-ee.x86_64 --showduplicates |sort -r
$ yum list docker-ee.x86_64 --showduplicates | sort -r
docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable
```
@ -238,9 +238,9 @@ to install.
### Install from a package
If you cannot use the official Docker repository to install Docker, you can
If you cannot use the official Docker repository to install Docker EE, you can
download the `.rpm` file for your release and install it manually. You will
need to download a new file each time you want to upgrade Docker.
need to download a new file each time you want to upgrade Docker EE.
1. Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Go to
@ -278,7 +278,7 @@ need to download a new file each time you want to upgrade Docker.
$ sudo systemctl start docker
```
6. Verify that `docker` is installed correctly by running the `hello-world`
6. Verify that Docker EE is installed correctly by running the `hello-world`
image.
```bash
@ -323,6 +323,6 @@ You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).
- Continue with the [User Guide](/engine/userguide/index.md).

45
engine/installation/linux/suse.md → engine/installation/linux/docker-ee/suse.md
View File

@ -1,9 +1,10 @@
---
description: Instructions for installing Docker on SLES
keywords: Docker, Docker documentation, requirements, apt, installation, suse, opensuse, sles, rpm, install, uninstall, upgrade, update
description: Instructions for installing Docker EE on SLES
keywords: requirements, apt, installation, suse, opensuse, sles, rpm, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/SUSE/
title: Get Docker for SLES
- /engine/installation/linux/suse/
title: Get Docker EE for SLES
---
{% assign minor-version = "17.03" %}
@ -34,10 +35,10 @@ Docker Community Edition (Docker CE) is not supported on SLES.
### OS requirements
To install Docker, you need the 64-bit version of SLES 12.x. Docker is not
To install Docker EE, you need the 64-bit version of SLES 12.x. Docker EE is not
supported on OpenSUSE.
The only supported storage driver for Docker on SLES is `btrfs`, which will be
The only supported storage driver for Docker EE on SLES is `btrfs`, which will be
used by default if the underlying filesystem hosting `/var/lib/docker/` is a
BTRFS filesystem.
@ -64,8 +65,9 @@ networks, are preserved. The Docker EE package is now called `docker-ee`.
## Configure the btrfs filesystem
If the filesystem which hosts `/var/lib/docker/` is not a BTRFS filesystem,
you must configure a BTRFS filesystem and mount it on `/var/lib/docker/`:
By default, SLES formats the `/` filesystem using BTRFS. If the filesystem which
hosts `/var/lib/docker/` is **not** a BTRFS filesystem, you must configure a
BTRFS filesystem and mount it on `/var/lib/docker/`:
1. Format your dedicated block device or devices as a Btrfs filesystem. This
example assumes that you are using two block devices called `/dev/xvdf` and
@ -90,9 +92,9 @@ you must configure a BTRFS filesystem and mount it on `/var/lib/docker/`:
entry to `/etc/fstab`.
## Install Docker
## Install Docker EE
You can install Docker in different ways, depending on your needs:
You can install Docker EE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
@ -105,9 +107,9 @@ You can install Docker in different ways, depending on your needs:
### Install using the repository
Before you install Docker for the first time on a new host machine, you need to
set up the Docker repository. Afterward, you can install and update Docker from
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
@ -153,7 +155,7 @@ the repository.
$ sudo service docker start
```
3. On production systems, you should install a specific version of Docker
3. On production systems, you should install a specific version of Docker EE
instead of always using the latest. List the available versions. The
following example only lists binary packages and is truncated. To also list
source packages, omit the `-t package` flag from the command.
@ -180,7 +182,7 @@ the repository.
$ sudo zypper install docker-ee-<VERSION_STRING>
```
4. Configure Docker to use the `btrfs` filesystem. **This is only required if
4. Configure Docker EE to use the `btrfs` filesystem. **This is only required if
the `/` filesystem is not using BTRFS.** However, explicitly specifying the
`storage-driver` has no harmful side effects.
@ -224,9 +226,9 @@ to install.
### Install from a package
If you cannot use the official Docker repository to install Docker, you can
If you cannot use the official Docker repository to install Docker EE, you can
download the `.rpm` file for your release and install it manually. You will
need to download a new file each time you want to upgrade Docker.
need to download a new file each time you want to upgrade Docker EE.
1. Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Go to
@ -246,7 +248,7 @@ need to download a new file each time you want to upgrade Docker.
$ sudo zypper install /path/to/package.rpm
```
4. Configure Docker to use the `btrfs` filesystem. **This is only required if
4. Configure Docker EE to use the `btrfs` filesystem. **This is only required if
the `/` filesystem is not using BTRFS.** However, explicitly specifying the
`storage-driver` has no harmful side effects.
@ -288,7 +290,7 @@ To upgrade Docker EE, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `zypper update`
instead of `zypper install`, and pointing to the new file.
## Uninstall Docker
## Uninstall Docker EE
1. Uninstall the Docker EE package using the following command.
@ -304,12 +306,13 @@ instead of `zypper install`, and pointing to the new file.
$ sudo rm -rf /var/lib/docker/*
```
As an alternative, you can unmount and format the `btrfs` filesystem.
If you used a separate BTRFS filesystem to host the contents of
`/var/lib/docker/`, you can unmount and format the `btrfs` filesystem.
You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).
- Continue with the [User Guide](/engine/userguide/index.md).

270
engine/installation/linux/docker-ee/ubuntu.md Normal file
View File

@ -0,0 +1,270 @@
---
description: Instructions for installing Docker EE on Ubuntu
keywords: requirements, apt, installation, ubuntu, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/ubuntulinux/
- /installation/ubuntulinux/
- /engine/installation/linux/ubuntulinux/
title: Get Docker EE for Ubuntu
---
{% assign minor-version = "17.03" %}
To get started with Docker EE on Ubuntu, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
## Prerequisites
Docker CE users should go to
[Get docker CE for CentOS](/engine/installatioin/linux/docker-ce/ubuntu.md)
**instead of this topic**.
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
repository URL associated with your trial or subscription. To get this information:
- Go to [https://store.docker.com/?overlay=subscriptions](https://store.docker.com/?overlay=subscriptions).
- Choose **Get Details** / **Setup Instructions** within the
**Docker Enterprise Edition for Ubuntu** section.
- Copy the URL from the field labeled
**Copy and paste this URL to download your Edition**.
Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
### OS requirements
To install Docker EE, you need the 64-bit version of one of these Ubuntu versions:
- Xenial 16.04 (LTS)
- Trusty 14.04 (LTS)
Docker EE is supported on `x86_64` architectures.
The only supported storage driver for Docker EE on Ubuntu is `aufs`.
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. In addition,
if you are upgrading from Docker CE to Docker EE, remove the Docker CE package.
```bash
$ sudo apt-get remove docker docker-engine docker-ce docker.io
```
It's OK if `apt-get` 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`.
### Extra packages for Trusty 14.04
Docker EE users must use the `aufs` storage driver on production systems. Install
the `linux-image-extra-*` packages, which allow Docker EE to use the `aufs`
storage driver.
```bash
$ sudo apt-get update
$ sudo apt-get install \
linux-image-extra-$(uname -r) \
linux-image-extra-virtual
```
## Install Docker EE
You can install Docker EE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.
- Some users download the DEB package and install it manually and manage
upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet.
### 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
1. Install packages to allow `apt` to use a repository over HTTPS:
```bash
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
```
2. Add Docker's official GPG key using your customer Docker EE repository URL:
```bash
$ curl -fsSL <DOCKER-EE-URL>/gpg | sudo apt-key add -
```
Verify that the key fingerprint is `DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`.
```bash
$ apt-key fingerprint 0EBFCD88
pub 4096R/6D085F96 2017-02-22
Key fingerprint = DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96
uid [ultimate] Docker Release (EE deb) <docker@docker.com>
sub 4096R/91A29FA3 2017-02-22
```
3. Use the following command to set up the **stable** repository, replacing
`<DOCKER-EE-URL>` with the URL you noted down in the
[prerequisites](#prerequisites).
> **Note**: The `lsb_release -cs` sub-command below returns the name of your
> Ubuntu distribution, such as `xenial`.
>
```bash
$ sudo add-apt-repository \
"deb [arch=amd64] <DOCKER-EE-URL> \
$(lsb_release -cs) \
stable-{{ minor-version }}"
```
#### Install Docker EE
1. Update the `apt` package index.
```bash
$ sudo apt-get update
```
2. Install the latest version of Docker EE, or go to the next step to install a
specific version. Any existing installation of Docker EE is replaced.
Use this command to install the latest version of Docker EE:
```bash
$ sudo apt-get install docker-ee
```
> **Warning**:
> If you have multiple Docker repositories enabled, installing
> or updating without specifying a version in the `apt-get install` or
> `apt-get update` command will always install the highest possible version,
> which may not be appropriate for your stability needs.
{:.warning}
3. On production systems, you should install a specific version of Docker EE
instead of always using the latest. This output is truncated. List the
available versions.
```bash
$ apt-cache madison docker-ee
docker-ee | {{ minor-version }}.0~ee-0~ubuntu-xenial | {{ download-url-base}} xenial/stable amd64 Packages
```
The contents of the list depend upon which repositories are enabled,
and will be specific to your version of Ubuntu (indicated by the `xenial`
suffix on the version, in this example). Choose a specific version to
install. The second column is the version string. The third column is the
repository name, which indicates which repository the package is from and
by extension its stability level. To install a specific version, append the
version string to the package name and separate them by an equals sign (`=`):
```bash
$ sudo apt-get install docker-ee=<VERSION>
```
The Docker daemon starts automatically.
4. Verify that Docker EE is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker EE is installed and running. You need to use `sudo` to run Docker
commands. Continue to [Linux postinstall](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker EE
To upgrade Docker EE, first run `sudo apt-get update`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
### Install from a package
If you cannot use Docker's repository to install Docker EE, you can download the
`.deb` file for your release and install it manually. You will need to download
a new file each time you want to upgrade Docker EE.
1. Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Go to
`x86_64/stable-{{ minor-version }}` and download the `.deb` file for the
Docker EE version you want to install.
2. Install Docker EE, changing the path below to the path where you downloaded
the Docker EE package.
```bash
$ sudo dpkg -i /path/to/package.deb
```
The Docker daemon starts automatically.
3. Verify that Docker EE is installed correctly by running the `hello-world`
image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker EE is installed and running. You need to use `sudo` to run Docker
commands. Continue to [Post-installation steps for Linux](linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional
configuration steps.
#### Upgrade Docker EE
To upgrade Docker EE, download the newer package file and repeat the
[installation procedure](#install-from-a-package), pointing to the new file.
## Uninstall Docker EE
1. Uninstall the Docker EE package:
```bash
$ sudo apt-get purge docker-ee
```
2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and
volumes:
```bash
$ sudo rm -rf /var/lib/docker
```
You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md)
- Continue with the [User Guide](/engine/userguide/index.md).

117
engine/installation/linux/gentoolinux.md
View File

@ -1,117 +0,0 @@
---
description: Installation instructions for Docker on Gentoo.
keywords: gentoo linux, docker, documentation, installation
redirect_from:
- /engine/installation/gentoolinux/
title: Install Docker on Gentoo
---
Installing Docker on Gentoo Linux can be accomplished using one of two ways: the **official** way and the `docker-overlay` way.
Official project page of [Gentoo Docker](https://wiki.gentoo.org/wiki/Project:Docker) team.
## Official way
The first and recommended way if you are looking for a stable
experience is to use the official `app-emulation/docker` package directly
from the tree.
If any issues arise from this ebuild including, missing kernel
configuration flags or dependencies, open a bug
on the Gentoo [Bugzilla](https://bugs.gentoo.org) assigned to `docker AT gentoo DOT org`
or join and ask in the official
[IRC](http://webchat.freenode.net?channels=%23gentoo-containers&uio=d4) channel on the Freenode network.
## docker-overlay way
If you're looking for a `-bin` ebuild, a live ebuild, or a bleeding edge
ebuild, use the provided overlay, [docker-overlay](https://github.com/tianon/docker-overlay)
which can be added using `app-portage/layman`. The most accurate and
up-to-date documentation for properly installing and using the overlay
can be found in the [overlay](https://github.com/tianon/docker-overlay/blob/master/README.md#using-this-overlay).
If any issues arise from this ebuild or the resulting binary, including
and especially missing kernel configuration flags or dependencies,
open an [issue](https://github.com/tianon/docker-overlay/issues) on
the `docker-overlay` repository or ping `tianon` directly in the `#docker`
IRC channel on the Freenode network.
## Installation
### Available USE flags
| USE Flag | Default | Description |
| ------------- |:-------:|:------------|
| aufs | |Enables dependencies for the "aufs" graph driver, including necessary kernel flags.|
| btrfs | |Enables dependencies for the "btrfs" graph driver, including necessary kernel flags.|
| contrib | Yes |Install additional contributed scripts and components.|
| device-mapper | Yes |Enables dependencies for the "devicemapper" graph driver, including necessary kernel flags.|
| doc | |Add extra documentation, such as API and Javadoc. It is recommended to enable per package instead of globally.|
| vim-syntax | |Pulls in related vim syntax scripts.|
| zsh-completion| |Enable zsh completion support.|
USE flags are described in detail on [tianon's
blog](https://tianon.github.io/post/2014/05/17/docker-on-gentoo.html).
The package should properly pull in all the necessary dependencies and
prompt for all necessary kernel options.
$ sudo emerge -av app-emulation/docker
>Note: Sometimes there is a disparity between the latest versions
>in the official **Gentoo tree** and the **docker-overlay**.
>Please be patient, and the latest version should propagate shortly.
## Starting Docker
Ensure that you are running a kernel that includes all the necessary
modules and configuration (and optionally for device-mapper
and AUFS or Btrfs, depending on the storage driver you've decided to use).
To use Docker, the `docker` daemon must be running as **root**.
To use Docker as a **non-root** user, add yourself to the **docker**
group by running the following command:
$ sudo groupadd docker
$ sudo usermod -a -G docker user
### OpenRC
To start the `docker` daemon:
$ sudo /etc/init.d/docker start
To start on system boot:
$ sudo rc-update add docker default
### systemd
To start the `docker` daemon:
$ sudo systemctl start docker
To start on system boot:
$ sudo systemctl enable docker
If you need to add an HTTP Proxy, set a different directory or partition for the
Docker runtime files, or make other customizations, read our systemd article to
learn how to [customize your systemd Docker daemon options](../../admin/systemd.md).
## Uninstallation
To uninstall the Docker package:
$ sudo emerge -cav app-emulation/docker
To uninstall the Docker package and dependencies that are no longer needed:
$ sudo emerge -C app-emulation/docker
The above commands will not remove images, containers, volumes, or user created
configuration files on your host. If you wish to delete all images, containers,
and volumes run the following command:
$ rm -rf /var/lib/docker
You must delete the user created configuration files manually.

17
engine/installation/linux/other.md
View File

@ -1,17 +0,0 @@
---
title: Installation on other Linux distributions
description: "Installing Docker on other Linux distributions"
---
This section lists installation instructions for community-maintained Docker
distributions. These instructions are not regularly tested. Consider
[installing from binaries](../binaries.md) instead.
- [Installation on Arch Linux](/engine/installation/linux/archlinux.md)
- [Installation on CRUX Linux](/engine/installation/linux/cruxlinux.md)
- [Installation on Gentoo Linux](/engine/installation/linux/gentoolinux.md)
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).

419
engine/installation/linux/ubuntu.md
View File

@ -1,417 +1,10 @@
---
description: Instructions for installing Docker on Ubuntu
keywords: Docker, Docker documentation, requirements, apt, installation, ubuntu, install, uninstall, upgrade, update
redirect_from:
- /engine/installation/ubuntulinux/
- /installation/ubuntulinux/
- /engine/installation/linux/ubuntulinux/
title: Get Docker for Ubuntu
description: Ubuntu installation landing page
title: Choose Docker CE or Docker EE on Ubuntu
---
{% assign minor-version = "17.03" %}
The instructions for installing Docker on Ubuntu depend on whether you are using
Docker EE or Docker CE.
To get started with Docker on Ubuntu, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker).
## Prerequisites
### Docker EE customers
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
repository URL associated with your trial or subscription. To get this information:
- Go to [https://store.docker.com/?overlay=subscriptions](https://store.docker.com/?overlay=subscriptions).
- Choose **Get Details** / **Setup Instructions** within the
**Docker Enterprise Edition for Ubuntu** section.
- Copy the URL from the field labeled
**Copy and paste this URL to download your Edition**.
Where the installation instructions differ for Docker EE and Docker CE, use this
URL when you see the placeholder text `<DOCKER-EE-URL>`.
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
### OS requirements
To install Docker, you need the 64-bit version of one of these Ubuntu versions:
- Yakkety 16.10
- Xenial 16.04 (LTS)
- Trusty 14.04 (LTS)
Docker CE is supported on both `x86_64` and `armhf` architectures.
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them:
```bash
$ sudo apt-get remove docker docker-engine
```
It's OK if `apt-get` reports that none of these packages are installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker CE package is now called `docker-ce`, and
the Docker EE package is now called `docker-ee`.
### Recommended extra packages for Trusty 14.04
Unless you have a strong reason not to, install the
`linux-image-extra-*` packages, which allow Docker to use the `aufs` storage
drivers.
```bash
$ sudo apt-get update
$ sudo apt-get install \
linux-image-extra-$(uname -r) \
linux-image-extra-virtual
```
## Install Docker
You can install Docker in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.
- Some users download the DEB package and install it manually and manage
upgrades completely manually. This is useful in situations such as installing
Docker on air-gapped systems with no access to the internet.
### Install using the repository
Before you install Docker for the first time on a new host machine, you need to
set up the Docker repository. Afterward, you can install and update Docker from
the repository.
#### Set up the repository
The procedure for setting up the repository is different for Docker CE and
Docker EE.
<ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-group="ce" data-target="#ce-repo-setup">Docker CE</a></li>
<li><a data-toggle="tab" data-group="ee" data-target="#ee-repo-setup">Docker EE</a></li>
</ul>
<div class="tab-content">
<div id="ce-repo-setup" class="tab-pane fade in active" markdown="1">
{% assign download-url-base = "https://download.docker.com/linux/ubuntu" %}
1. Install packages to allow `apt` to use a repository over HTTPS:
```bash
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
```
2. Add Docker's official GPG key:
```bash
$ curl -fsSL {{ download-url-base}}/gpg | sudo apt-key add -
```
Verify that the key fingerprint is `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`.
```bash
$ sudo apt-key fingerprint 0EBFCD88
pub 4096R/0EBFCD88 2017-02-22
Key fingerprint = 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
uid Docker Release (CE deb) <docker@docker.com>
sub 4096R/F273FCD8 2017-02-22
```
3. Use the following command to set up the **stable** repository. You always
need the **stable** repository, even if you want to install **edge** builds
as well.
> **Note**: The `lsb_release -cs` sub-command below returns the
name of your Ubuntu distribution, such as `xenial`. Sometimes,
in a distribution like Linux Mint, you might have to
change `$(lsb_release -cs)` to your parent Ubuntu distribution.
For example: If you are using `Linux Mint Rafaela`, you could use
`trusty`.
**amd64**:
```bash
$ sudo add-apt-repository \
"deb [arch=amd64] {{ download-url-base }} \
$(lsb_release -cs) \
stable"
```
**armhf**:
```bash
$ sudo add-apt-repository \
"deb [arch=armhf] {{ download-url-base }} \
$(lsb_release -cs) \
stable"
```
[Learn about **stable** and **edge** channels](/engine/installation/).
</div>
<div id="ee-repo-setup" class="tab-pane fade" markdown="1">
1. Install packages to allow `apt` to use a repository over HTTPS:
```bash
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
```
2. Add Docker's official GPG key using your customer Docker EE repository URL:
```bash
$ curl -fsSL <DOCKER-EE-URL>/gpg | sudo apt-key add -
```
Verify that the key fingerprint is `DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`.
```bash
$ apt-key fingerprint 0EBFCD88
pub 4096R/6D085F96 2017-02-22
Key fingerprint = DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96
uid [ultimate] Docker Release (EE deb) <docker@docker.com>
sub 4096R/91A29FA3 2017-02-22
```
3. Use the following command to set up the **stable** repository, replacing
`<DOCKER-EE-URL>` with the URL you noted down in the
[prerequisites](#prerequisites).
> **Note**: The `lsb_release -cs` sub-command below returns the name of your
> Ubuntu distribution, such as `xenial`.
>
```bash
$ sudo add-apt-repository \
"deb [arch=amd64] <DOCKER-EE-URL> \
$(lsb_release -cs) \
stable-{{ minor-version }}"
```
</div>
</div>
#### Install Docker
1. Update the `apt` package index.
```bash
$ sudo apt-get update
```
2. Install the latest version of Docker, or go to the next step to install a
specific version. Any existing installation of Docker is replaced.
Use this command to install the latest version of Docker:
<ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-group="ce" data-target="#ce-install-docker">Docker CE</a></li>
<li><a data-toggle="tab" data-group="ee" data-target="#ee-install-docker">Docker EE</a></li>
</ul>
<div class="tab-content">
<div id="ce-install-docker" class="tab-pane fade in active" markdown="1">
```bash
$ sudo apt-get install docker-ce
```
</div>
<div id="ee-install-docker" class="tab-pane fade" markdown="1">
```bash
$ sudo apt-get install docker-ee
```
</div>
</div>
> **Warning**: If you have multiple Docker repositories enabled, installing
> or updating without specifying a version in the `apt-get install` or
> `apt-get update` command will always install the newest possible version,
> which may not be appropriate for your stability needs.
{: .warning-vanilla}
3. On production systems, you should install a specific version of Docker
instead of always using the latest. This output is truncated. List the
available versions. For Docker EE customers, use `docker-ee` where you see
`docker-ce`.
```bash
$ apt-cache madison docker-ce
docker-ce | {{ minor-version }}.0~ce-0~ubuntu-xenial | {{ download-url-base}} xenial/stable amd64 Packages
```
The contents of the list depend upon which repositories are enabled,
and will be specific to your version of Ubuntu (indicated by the `xenial`
suffix on the version, in this example). Choose a specific version to
install. The second column is the version string. The third column is the
repository name, which indicates which repository the package is from and
by extension its stability level. To install a specific version, append the
version string to the package name and separate them by an equals sign (`=`):
<ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-group="ce" data-target="#ce-install-version-docker">Docker CE</a></li>
<li><a data-toggle="tab" data-group="ee" data-target="#ee-install-version-docker">Docker EE</a></li>
</ul>
<div class="tab-content">
<div id="ce-install-version-docker" class="tab-pane fade in active" markdown="1">
```bash
$ sudo apt-get install docker-ce=<VERSION>
```
</div>
<div id="ee-install-version-docker" class="tab-pane fade" markdown="1">
```bash
$ sudo apt-get install docker-ee=<VERSION>
```
</div>
</div>
The Docker daemon starts automatically.
4. Verify that Docker CE or Docker EE is installed correctly by running the
`hello-world` image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Linux postinstall](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker
To upgrade Docker, first run `sudo apt-get update`, then follow the
[installation instructions](#install-docker), choosing the new version you want
to install.
### Install from a package
If you cannot use Docker's repository to install Docker, you can download the
`.deb` file for your release and install it manually. You will need to download
a new file each time you want to upgrade Docker.
1. This step is different for Docker CE and Docker EE.
<ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-group="ce" data-target="#ce-install-from-package-docker">Docker CE</a></li>
<li><a data-toggle="tab" data-group="ee" data-target="#ee-install-from-package-docker">Docker EE</a></li>
</ul>
<div class="tab-content">
<div id="ce-install-from-package-docker" class="tab-pane fade in active" markdown="1">
Go to [{{ download-url-base }}/dists/]({{ download-url-base }}/dists/), choose your
Ubuntu version, browse to `pool/stable/`, choose either `amd64` or
`armhf`,and download the `.deb` file for the Docker version you want to
install and for your version of Ubuntu.
> **Note**: To install an **edge** package, change the word
> `stable` in the URL to `edge`.
> [Learn about **stable** and **edge** channels](/engine/installation/).
</div>
<div id="ee-install-from-package-docker" class="tab-pane fade" markdown="1">
Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Go to
`x86_64/stable-{{ minor-version }}` and download the `.deb` file for the
Docker version you want to install.
</div>
</div>
2. Install Docker, changing the path below to the path where you downloaded
the Docker package.
```bash
$ sudo dpkg -i /path/to/package.deb
```
The Docker daemon starts automatically.
3. Verify that Docker CE or Docker EE is installed correctly by running the
`hello-world` image.
```bash
$ sudo docker run hello-world
```
This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits.
Docker is installed and running. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
#### Upgrade Docker
To upgrade Docker, download the newer package file and repeat the
[installation procedure](#install-from-a-package), pointing to the new file.
## Uninstall Docker
1. Uninstall the Docker package:
<ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-group="ce" data-target="#ce-uninstall-version-docker">Docker CE</a></li>
<li><a data-toggle="tab" data-group="ee" data-target="#ee-uninstall-version-docker">Docker EE</a></li>
</ul>
<div class="tab-content">
<div id="ce-uninstall-version-docker" class="tab-pane fade in active" markdown="1">
```bash
$ sudo apt-get purge docker-ce
```
</div>
<div id="ee-uninstall-version-docker" class="tab-pane fade" markdown="1">
```bash
$ sudo apt-get purge docker-ee
```
</div>
</div>
2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and
volumes:
```bash
$ sudo rm -rf /var/lib/docker
```
You must delete any edited configuration files manually.
## Next steps
- Continue to [Post-installation steps for Linux](linux-postinstall.md)
- Continue with the [User Guide](../../userguide/index.md).
- [Install Docker EE on Ubuntu](/engine/installation/linux/docker-ee/ubuntu.md)
- [Install Docker CE on Ubuntu](/engine/installation/linux/docker-ce/ubuntu.md)

2
docker-ee-for-windows/install.md → engine/installation/windows/docker-ee.md
View File

@ -2,6 +2,8 @@
description: How to install Docker EE for Windows
keywords: windows, windows server, install, download
title: Install Docker Enterprise Edition for Windows Server 2016
redirect_from:
- /engine/installation/windows/docker-ee/
---
Docker Enterprise Edition for Windows Server 2016 (*Docker EE*) enables native