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

Merge pull request #8005 from thaJeztah/remove_wheezy_jessie 

Installation docs: remove distros that are no longer supported, and cleanup/align instructions
This commit is contained in:
Anne Henmi 2019-01-14 16:29:21 -05:00 committed by GitHub
parent dc82c9abd0 a68622b754
commit 46145f7bf9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 77 additions and 201 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

152
install/linux/docker-ce/debian.md
View File

@ -27,18 +27,15 @@ and distributions for different Docker editions, see
To install Docker CE, 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: Raspbian versions:
- Buster 10 (Docker CE 17.11 Edge only) - Buster 10
- Stretch 9 (stable) / Raspbian Stretch - Stretch 9 (stable) / Raspbian Stretch
- Jessie 8 (LTS) / Raspbian Jessie
- Wheezy 7.7 (LTS)
Docker CE is supported on `x86_64` (or `amd64`), `armhf`, and `arm64` architectures for Jessie and Docker CE is supported on `x86_64` (or `amd64`), `armhf`, and `arm64` architectures.
Stretch.
### Uninstall old versions ### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are Older versions of Docker were called `docker`, `docker.io `, or `docker-engine`.
installed, uninstall them: If these are installed, uninstall them:
```bash ```bash
$ sudo apt-get remove docker docker-engine docker.io containerd runc $ sudo apt-get remove docker docker-engine docker.io containerd runc
@ -49,20 +46,6 @@ 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 The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker CE package is now called `docker-ce`. networks, are preserved. The Docker CE package is now called `docker-ce`.
### Extra steps for Wheezy 7.7
- You need at least version 3.10 of the Linux kernel. Debian Wheezy ships with
version 3.2, so you may need to
[update the kernel](https://wiki.debian.org/HowToUpgradeKernel){: target="_blank" class="_" }.
To check your kernel version:
```bash
$ uname -r
```
- Enable the `backports` repository. See the
[Debian documentation](https://backports.debian.org/Instructions/){: target="_blank" class"_"}.
## Install Docker CE ## Install Docker CE
You can install Docker CE in different ways, depending on your needs: You can install Docker CE in different ways, depending on your needs:
@ -94,7 +77,7 @@ from the repository.
#### Set up the repository #### Set up the repository
{% assign download-url-base = 'https://download.docker.com/linux/debian' %} {% assign download-url-base = "https://download.docker.com/linux/debian" %}
1. Update the `apt` package index: 1. Update the `apt` package index:
@ -104,40 +87,19 @@ from the repository.
2. Install packages to allow `apt` to use a repository over HTTPS: 2. Install packages to allow `apt` to use a repository over HTTPS:
<ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-target="#jessie">Jessie or newer</a></li>
<li><a data-toggle="tab" data-target="#wheezy">Wheezy or older</a></li>
</ul>
<div class="tab-content">
<div id="jessie" class="tab-pane fade in active" markdown="1">
```bash ```bash
$ sudo apt-get install \ $ sudo apt-get install \
apt-transport-https \ apt-transport-https \
ca-certificates \ ca-certificates \
curl \ curl \
gnupg2 \ gnupg2 \
software-properties-common software-properties-common
``` ```
</div>
<div id="wheezy" class="tab-pane fade" markdown="1">
```bash
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
python-software-properties
```
</div>
</div> <!-- tab-content -->
3. Add Docker's official GPG key: 3. Add Docker's official GPG key:
```bash ```bash
$ curl -fsSL {{ download-url-base}}/gpg | sudo apt-key add - $ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add -
``` ```
Verify that you now have the key with the fingerprint Verify that you now have the key with the fingerprint
@ -160,7 +122,7 @@ from the repository.
word `stable` in the commands below. word `stable` in the commands below.
> **Note**: The `lsb_release -cs` sub-command below returns the name of your > **Note**: The `lsb_release -cs` sub-command below returns the name of your
> Debian distribution, such as `jessie`. > Debian distribution, such as `stretch`.
To also add the **edge** repository, add `edge` after `stable` on the last To also add the **edge** repository, add `edge` after `stable` on the last
line of the command. line of the command.
@ -184,34 +146,25 @@ from the repository.
<div id="armhf_repo" class="tab-pane fade" markdown="1"> <div id="armhf_repo" class="tab-pane fade" markdown="1">
```bash ```bash
$ echo "deb [arch=armhf] {{ download-url-base }} \ $ sudo add-apt-repository \
$(lsb_release -cs) stable" | \ "deb [arch=armhf] {{ download-url-base }} \
sudo tee /etc/apt/sources.list.d/docker.list $(lsb_release -cs) \
stable"
``` ```
</div> </div>
<div id="arm64_repo" class="tab-pane fade" markdown="1"> <div id="arm64_repo" class="tab-pane fade" markdown="1">
```bash ```bash
$ echo "deb [arch=arm64] {{ download-url-base }} \ $ sudo add-apt-repository \
$(lsb_release -cs) stable" | \ "deb [arch=arm64] {{ download-url-base }} \
sudo tee /etc/apt/sources.list.d/docker.list $(lsb_release -cs) \
stable"
``` ```
</div> </div>
</div> <!-- tab-content --> </div> <!-- tab-content -->
5. **Wheezy only**: The version of `add-apt-repository` on Wheezy adds a `deb-src`
repository that does not exist. You need to comment out this repository or
running `apt-get update` fails. Edit `/etc/apt/sources.list`. Find the
line like the following, and comment it out or remove it:
```none
deb-src [arch=amd64] https://download.docker.com/linux/debian wheezy stable
```
Save and exit the file.
> **Note**: Starting with Docker 17.06, stable releases are also pushed to > **Note**: Starting with Docker 17.06, stable releases are also pushed to
> the **edge** and **test** repositories. > the **edge** and **test** repositories.
@ -248,44 +201,35 @@ from the repository.
```bash ```bash
$ apt-cache madison docker-ce $ apt-cache madison docker-ce
docker-ce | {{ site.docker_ce_stable_version }}.0~ce-0~debian | https://download.docker.com/linux/debian jessie/stable amd64 Packages docker-ce | 5:18.09.1~3-0~debian-stretch | {{ download-url-base }} stretch/stable amd64 Packages
docker-ce | 5:18.09.0~3-0~debian-stretch | {{ download-url-base }} stretch/stable amd64 Packages
docker-ce | 18.06.1~ce~3-0~debian | {{ download-url-base }} stretch/stable amd64 Packages
docker-ce | 18.06.0~ce~3-0~debian | {{ download-url-base }} stretch/stable amd64 Packages
...
``` ```
b. Install a specific version by its fully qualified package name, which is b. Install a specific version using the version string from the second column,
the package name (`docker-ce`) plus the version string (2nd column) up to for example, `5:18.09.1~3-0~debian-stretch `.
the first hyphen, separated by an equals sign (`=`), for example,
`docker-ce=18.03.0.ce`.
```bash ```bash
$ sudo apt-get install docker-ce=<VERSION_STRING> $ sudo apt-get install docker-ce=<VERSION_STRING>
``` ```
The Docker daemon starts automatically.
4. Verify that Docker CE is installed correctly by running the `hello-world` 4. Verify that Docker CE is installed correctly by running the `hello-world`
image. image.
**x86_64**:
```bash ```bash
$ sudo docker run hello-world $ sudo docker run hello-world
``` ```
**armhf**:
```bash
$ sudo docker run armhf/hello-world
```
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker CE is installed and running. The `docker` group is created but no users Docker CE is installed and running. The `docker` group is created but no users
are added to it. You need to use `sudo` to run Docker are added to it. You need to use `sudo` to run Docker commands.
commands. Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration non-privileged users to run Docker commands and for other optional configuration
steps. For Raspbian, you can optionally steps.
[install Docker Compose for Raspbian](#install-docker-compose-for-raspbian).
#### Upgrade Docker CE #### Upgrade Docker CE
@ -299,10 +243,10 @@ 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 need to download `.deb` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker. a new file each time you want to upgrade Docker.
1. Go to `{{ download-url-base }}/dists/`, 1. Go to [`{{ download-url-base }}/dists/`]({{ download-url-base }}/dists/){: target="_blank" class="_" },
choose your Debian version, browse to `pool/stable/`, choose choose your Debian version, browse to `pool/stable/`, choose `amd64`,
`amd64`, `armhf`, or `arm64` and download the `.deb` file for the Docker CE version you `armhf`, or `arm64` and download the `.deb` file for the Docker CE version
want to install. you want to install.
> **Note**: To install an **edge** package, change the word > **Note**: To install an **edge** package, change the word
> `stable` in the URL to `edge`. > `stable` in the URL to `edge`.
@ -328,37 +272,18 @@ a new file each time you want to upgrade Docker.
container runs, it prints an informational message and exits. container runs, it prints an informational message and exits.
Docker CE is installed and running. The `docker` group is created but no users Docker CE is installed and running. The `docker` group is created but no users
are added to it. You need to use `sudo` to run Docker are added to it. You need to use `sudo` to run Docker commands.
commands. Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional to allow non-privileged users to run Docker commands and for other optional
configuration steps. For Raspbian, you can optionally configuration steps.
[install Docker Compose for Raspbian](#install-docker-compose-for-raspbian).
#### Upgrade Docker CE #### 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), pointing to the new file. [installation procedure](#install-from-a-package), pointing to the new file.
{% include install-script.md %} {% include install-script.md %}
## Install Docker Compose for Raspbian
You can install Docker Compose using `pip`:
```bash
$ sudo pip install docker-compose
```
[Hypriot](https://hypriot.com/){: target="_blank" class="_" } provides a static
binary of `docker-compose` for Raspbian. It may not always be up to date, but if
space is at a premium, you may find it useful. To use it, first follow Hypriot's
[instructions for setting up the repository](https://blog.hypriot.com/post/your-number-one-source-for-docker-on-arm/){: target="_blank" class="_" },
then run the following command:
```bash
sudo apt-get install docker-compose
```
## Uninstall Docker CE ## Uninstall Docker CE
1. Uninstall the Docker CE package: 1. Uninstall the Docker CE package:
@ -380,5 +305,4 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) - Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
- Continue with the [User Guide](/engine/userguide/index.md). - Continue with the [User Guide](/engine/userguide/index.md).

3
install/linux/docker-ce/fedora.md
View File

@ -25,9 +25,8 @@ and distributions for different Docker editions, see
To install Docker, you need the 64-bit version of one of these Fedora versions: To install Docker, you need the 64-bit version of one of these Fedora versions:
- 26
- 27
- 28 - 28
- 29
### Uninstall old versions ### Uninstall old versions

123
install/linux/docker-ce/ubuntu.md
View File

@ -32,18 +32,17 @@ To learn more about Docker EE, see
To install Docker CE, you need the 64-bit version of one of these Ubuntu To install Docker CE, you need the 64-bit version of one of these Ubuntu
versions: versions:
- Cosmic 18.10
- Bionic 18.04 (LTS) - Bionic 18.04 (LTS)
- Xenial 16.04 (LTS) - Xenial 16.04 (LTS)
- Trusty 14.04 (LTS)
Docker CE is supported on Ubuntu on `x86_64`, `arm64`, `armhf`, `s390x` (IBM Z), and `ppc64le` (IBM Power) architectures. Docker CE is supported on `x86_64` (or `amd64`), `armhf`, `arm64`, `s390x`
(IBM Z), and `ppc64le` (IBM Power) architectures.
> **`ppc64le` and `s390x` limitations**: Packages for IBM Z and Power architectures are only available on Ubuntu Xenial and above.
### Uninstall old versions ### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are Older versions of Docker were called `docker`, `docker.io `, or `docker-engine`.
installed, uninstall them: If these are installed, uninstall them:
```bash ```bash
$ sudo apt-get remove docker docker-engine docker.io containerd runc $ sudo apt-get remove docker docker-engine docker.io containerd runc
@ -58,45 +57,10 @@ networks, are preserved. The Docker CE package is now called `docker-ce`.
Docker CE on Ubuntu supports `overlay2` and `aufs` storage drivers. Docker CE on Ubuntu supports `overlay2` and `aufs` storage drivers.
- For new installations on version 4 and higher of the Linux kernel, `overlay2` For new installations on version 4 and higher of the Linux kernel, `overlay2`
is supported and preferred over `aufs`. is supported and preferred over `aufs`. Docker CE uses the `overlay2`
- For version 3 of the Linux kernel, `aufs` is supported because `overlay` or storage driver by default. If you need to use `aufs` instead, you need to
`overlay2` drivers are not supported by that kernel version. configure it manually. See [aufs](/engine/userguide/storagedriver/aufs-driver.md)
If you need to use `aufs`, you need to do additional preparation as
outlined below.
#### Extra steps for aufs
<ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-target="#aufs_prep_xenial">Xenial 16.04 and newer</a></li>
<li><a data-toggle="tab" data-target="#aufs_prep_trusty">Trusty 14.04</a></li>
</ul>
<div class="tab-content">
<div id="aufs_prep_xenial" class="tab-pane fade in active" markdown="1">
For Ubuntu 16.04 and higher, the Linux kernel includes support for OverlayFS,
and Docker CE uses the `overlay2` storage driver by default. If you need
to use `aufs` instead, you need to configure it manually.
See [aufs](/engine/userguide/storagedriver/aufs-driver.md)
</div>
<div id="aufs_prep_trusty" class="tab-pane fade" markdown="1">
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
```
</div>
</div> <!-- tab-content -->
## Install Docker CE ## Install Docker CE
@ -117,9 +81,9 @@ You can install Docker CE in different ways, depending on your needs:
### Install using the repository ### Install using the repository
Before you install Docker CE for the first time on a new host machine, you need to Before you install Docker CE for the first time on a new host machine, you need
set up the Docker repository. Afterward, you can install and update Docker from to set up the Docker repository. Afterward, you can install and update Docker
the repository. from the repository.
#### Set up the repository #### Set up the repository
@ -138,6 +102,7 @@ the repository.
apt-transport-https \ apt-transport-https \
ca-certificates \ ca-certificates \
curl \ curl \
gnupg2 \
software-properties-common software-properties-common
``` ```
@ -170,16 +135,15 @@ the repository.
> Ubuntu distribution, such as `xenial`. Sometimes, in a distribution > Ubuntu distribution, such as `xenial`. Sometimes, in a distribution
> like Linux Mint, you might need to change `$(lsb_release -cs)` > like Linux Mint, you might need to change `$(lsb_release -cs)`
> to your parent Ubuntu distribution. For example, if you are using > to your parent Ubuntu distribution. For example, if you are using
> `Linux Mint Rafaela`, you could use `trusty`. > `Linux Mint Tessa`, you could use `bionic`.
<ul class="nav nav-tabs"> <ul class="nav nav-tabs">
<li class="active"><a data-toggle="tab" data-target="#x86_64_repo">x86_64 / amd64</a></li> <li class="active"><a data-toggle="tab" data-target="#x86_64_repo">x86_64 / amd64</a></li>
<li><a data-toggle="tab" data-target="#arm64">arm64</a></li> <li><a data-toggle="tab" data-target="#armhf_repo">armhf</a></li>
<li><a data-toggle="tab" data-target="#armhf">armhf</a></li> <li><a data-toggle="tab" data-target="#arm64_repo">arm64</a></li>
<li><a data-toggle="tab" data-target="#arm64">arm64</a></li> <li><a data-toggle="tab" data-target="#ppc64le_repo">ppc64le (IBM Power)</a></li>
<li><a data-toggle="tab" data-target="#ppc64le_repo">IBM Power (ppc64le)</a></li> <li><a data-toggle="tab" data-target="#s390x_repo">s390x (IBM Z)</a></li>
<li><a data-toggle="tab" data-target="#s390x_repo">IBM Z (s390x)</a></li>
</ul> </ul>
<div class="tab-content"> <div class="tab-content">
<div id="x86_64_repo" class="tab-pane fade in active" markdown="1"> <div id="x86_64_repo" class="tab-pane fade in active" markdown="1">
@ -192,17 +156,7 @@ the repository.
``` ```
</div> </div>
<div id="arm64" class="tab-pane fade" markdown="1"> <div id="armhf_repo" class="tab-pane fade" markdown="1">
```bash
$ sudo add-apt-repository \
"deb [arch=arm64] {{ download-url-base }} \
$(lsb_release -cs) \
stable"
```
</div>
<div id="armhf" class="tab-pane fade" markdown="1">
```bash ```bash
$ sudo add-apt-repository \ $ sudo add-apt-repository \
@ -212,7 +166,7 @@ the repository.
``` ```
</div> </div>
<div id="arm64" class="tab-pane fade" markdown="1"> <div id="arm64_repo" class="tab-pane fade" markdown="1">
```bash ```bash
$ sudo add-apt-repository \ $ sudo add-apt-repository \
@ -249,7 +203,6 @@ the repository.
[Learn about **stable** and **edge** channels](/install/index.md). [Learn about **stable** and **edge** channels](/install/index.md).
#### Install Docker CE #### Install Docker CE
1. Update the `apt` package index. 1. Update the `apt` package index.
@ -278,24 +231,25 @@ the repository.
```bash ```bash
$ apt-cache madison docker-ce $ apt-cache madison docker-ce
docker-ce | {{ site.docker_ce_stable_version }}.0~ce-0~ubuntu | {{ download-url-base }} xenial/stable amd64 Packages docker-ce | 5:18.09.1~3-0~ubuntu-xenial | {{ download-url-base }} xenial/stable amd64 Packages
docker-ce | 5:18.09.0~3-0~ubuntu-xenial | {{ download-url-base }} xenial/stable amd64 Packages
docker-ce | 18.06.1~ce~3-0~ubuntu | {{ download-url-base }} xenial/stable amd64 Packages
docker-ce | 18.06.0~ce~3-0~ubuntu | {{ download-url-base }} xenial/stable amd64 Packages
...
``` ```
b. Install a specific version by its fully qualified package name, which is b. Install a specific version using the version string from the second column,
package name (`docker-ce`) "=" version string (2nd column), for example, for example, `5:18.09.1~3-0~ubuntu-xenial`.
`docker-ce=18.03.0~ce-0~ubuntu`.
```bash ```bash
$ sudo apt-get install docker-ce=<VERSION> $ sudo apt-get install docker-ce=<VERSION_STRING>
``` ```
The Docker daemon starts automatically.
4. Verify that Docker CE is installed correctly by running the `hello-world` 4. Verify that Docker CE is installed correctly by running the `hello-world`
image. image.
```bash ```bash
$ sudo docker container run hello-world $ sudo docker run hello-world
``` ```
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
@ -317,12 +271,12 @@ to install.
If you cannot use Docker's repository to install Docker CE, you can download the 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 need to download `.deb` file for your release and install it manually. You need to download
a new file each time you want to upgrade Docker CE. a new file each time you want to upgrade Docker.
1. Go to [{{ download-url-base }}/dists/]({{ download-url-base }}/dists/), 1. Go to [`{{ download-url-base }}/dists/`]({{ download-url-base }}/dists/){: target="_blank" class="_" },
choose your Ubuntu version, browse to `pool/stable/` and choose `amd64`, choose your Ubuntu version, browse to `pool/stable/`, choose `amd64`,
`arm64`, `armhf`, `ppc64el`, or `s390x`. Download the `.deb` file for the `armhf`, `arm64`, `ppc64el`, or `s390x`, and download the `.deb` file for the
Docker version you want to install. Docker CE version you want to install.
> **Note**: To install an **edge** package, change the word > **Note**: To install an **edge** package, change the word
> `stable` in the URL to `edge`. > `stable` in the URL to `edge`.
@ -341,7 +295,7 @@ a new file each time you want to upgrade Docker CE.
image. image.
```bash ```bash
$ sudo docker container run hello-world $ sudo docker run hello-world
``` ```
This command downloads a test image and runs it in a container. When the This command downloads a test image and runs it in a container. When the
@ -349,9 +303,9 @@ a new file each time you want to upgrade Docker CE.
Docker CE is installed and running. The `docker` group is created but no users Docker CE is installed and running. The `docker` group is created but no users
are added to it. You need to use `sudo` to run Docker commands. are added to it. You need to use `sudo` to run Docker commands.
Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) to allow Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
non-privileged users to run Docker commands and for other optional configuration to allow non-privileged users to run Docker commands and for other optional
steps. configuration steps.
#### Upgrade Docker CE #### Upgrade Docker CE
@ -381,5 +335,4 @@ You must delete any edited configuration files manually.
## Next steps ## Next steps
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md) - Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
- Continue with the [User Guide](/engine/userguide/index.md). - Continue with the [User Guide](/engine/userguide/index.md).