@@ -27,18 +27,15 @@ and distributions for different Docker editions, see
2727To install Docker CE, you need the 64-bit version of one of these Debian or
2828Raspbian versions:
2929
30- - Buster 10 (Docker CE 17.11 Edge only)
30+ - Buster 10
3131- Stretch 9 (stable) / Raspbian Stretch
32- - Jessie 8 (LTS) / Raspbian Jessie
33- - Wheezy 7.7 (LTS)
3432
35- Docker CE is supported on ` x86_64 ` (or ` amd64 ` ), ` armhf ` , and ` arm64 ` architectures for Jessie and
36- Stretch.
33+ Docker CE is supported on ` x86_64 ` (or ` amd64 ` ), ` armhf ` , and ` arm64 ` architectures.
3734
3835### Uninstall old versions
3936
40- Older versions of Docker were called ` docker ` or ` docker-engine ` . If these are
41- installed, uninstall them:
37+ Older versions of Docker were called ` docker ` , ` docker.io ` , or ` docker-engine ` .
38+ If these are installed, uninstall them:
4239
4340``` bash
4441$ 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.
4946The contents of ` /var/lib/docker/ ` , including images, containers, volumes, and
5047networks, are preserved. The Docker CE package is now called ` docker-ce ` .
5148
52- ### Extra steps for Wheezy 7.7
53-
54- - You need at least version 3.10 of the Linux kernel. Debian Wheezy ships with
55- version 3.2, so you may need to
56- [ update the kernel] ( https://wiki.debian.org/HowToUpgradeKernel ) {: target="_ blank" class="_ " }.
57- To check your kernel version:
58-
59- ``` bash
60- $ uname -r
61- ```
62-
63- - Enable the ` backports ` repository. See the
64- [ Debian documentation] ( https://backports.debian.org/Instructions/ ) {: target="_ blank" class"_ "}.
65-
6649## Install Docker CE
6750
6851You can install Docker CE in different ways, depending on your needs:
@@ -94,7 +77,7 @@ from the repository.
9477
9578#### Set up the repository
9679
97- {% assign download-url-base = ' https://download.docker.com/linux/debian ' %}
80+ {% assign download-url-base = " https://download.docker.com/linux/debian " %}
9881
99821 . Update the ` apt ` package index:
10083
@@ -104,40 +87,19 @@ from the repository.
10487
105882. Install packages to allow ` apt` to use a repository over HTTPS:
10689
107- < ul class=" nav nav-tabs" >
108- < li class=" active" ><a data-toggle=" tab" data-target=" #jessie" > Jessie or newer< /a></li>
109- < li><a data-toggle=" tab" data-target=" #wheezy" > Wheezy or older< /a></li>
110- < /ul>
111- < div class=" tab-content" >
112- < div id=" jessie" class=" tab-pane fade in active" markdown=" 1" >
113-
114- ` ` ` bash
115- $ sudo apt-get install \
116- apt-transport-https \
117- ca-certificates \
118- curl \
119- gnupg2 \
120- software-properties-common
121- ` ` `
122-
123- < /div>
124- < div id=" wheezy" class=" tab-pane fade" markdown=" 1" >
125-
12690 ` ` ` bash
12791 $ sudo apt-get install \
128- apt-transport-https \
129- ca-certificates \
130- curl \
131- python-software-properties
92+ apt-transport-https \
93+ ca-certificates \
94+ curl \
95+ gnupg2 \
96+ software-properties-common
13297 ` ` `
13398
134- < /div>
135- < /div> < ! -- tab-content -->
136-
137993. Add Docker' s official GPG key:
138100
139101 ```bash
140- $ curl -fsSL {{ download-url-base}}/gpg | sudo apt-key add -
102+ $ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add -
141103 ```
142104
143105 Verify that you now have the key with the fingerprint
@@ -160,7 +122,7 @@ from the repository.
160122 word `stable` in the commands below.
161123
162124 > **Note**: The `lsb_release -cs` sub-command below returns the name of your
163- > Debian distribution, such as `jessie `.
125+ > Debian distribution, such as `stretch `.
164126
165127 To also add the **edge** repository, add `edge` after `stable` on the last
166128 line of the command.
@@ -184,34 +146,25 @@ from the repository.
184146 <div id="armhf_repo" class="tab-pane fade" markdown="1">
185147
186148 ```bash
187- $ echo "deb [arch=armhf] {{ download-url-base }} \
188- $(lsb_release -cs) stable" | \
189- sudo tee /etc/apt/sources.list.d/docker.list
149+ $ sudo add-apt-repository \
150+ "deb [arch=armhf] {{ download-url-base }} \
151+ $(lsb_release -cs) \
152+ stable"
190153 ```
191154
192155 </div>
193156 <div id="arm64_repo" class="tab-pane fade" markdown="1">
194157
195158 ```bash
196- $ echo "deb [arch=arm64] {{ download-url-base }} \
197- $(lsb_release -cs) stable" | \
198- sudo tee /etc/apt/sources.list.d/docker.list
159+ $ sudo add-apt-repository \
160+ "deb [arch=arm64] {{ download-url-base }} \
161+ $(lsb_release -cs) \
162+ stable"
199163 ```
200164
201165 </div>
202166 </div> <!-- tab-content -->
203167
204- 5. **Wheezy only**: The version of `add-apt-repository` on Wheezy adds a `deb-src`
205- repository that does not exist. You need to comment out this repository or
206- running `apt-get update` fails. Edit `/etc/apt/sources.list`. Find the
207- line like the following, and comment it out or remove it:
208-
209- ```none
210- deb-src [arch=amd64] https://download.docker.com/linux/debian wheezy stable
211- ```
212-
213- Save and exit the file.
214-
215168 > **Note**: Starting with Docker 17.06, stable releases are also pushed to
216169 > the **edge** and **test** repositories.
217170
@@ -248,44 +201,35 @@ from the repository.
248201 ```bash
249202 $ apt-cache madison docker-ce
250203
251- docker-ce | {{ site.docker_ce_stable_version }}.0~ce-0~debian | https://download.docker.com/linux/debian jessie/stable amd64 Packages
204+ docker-ce | 5:18.09.1~3-0~debian-stretch | {{ download-url-base }} stretch/stable amd64 Packages
205+ docker-ce | 5:18.09.0~3-0~debian-stretch | {{ download-url-base }} stretch/stable amd64 Packages
206+ docker-ce | 18.06.1~ce~3-0~debian | {{ download-url-base }} stretch/stable amd64 Packages
207+ docker-ce | 18.06.0~ce~3-0~debian | {{ download-url-base }} stretch/stable amd64 Packages
208+ ...
252209 ```
253210
254- b. Install a specific version by its fully qualified package name, which is
255- the package name (`docker-ce`) plus the version string (2nd column) up to
256- the first hyphen, separated by an equals sign (`=`), for example,
257- `docker-ce=18.03.0.ce`.
211+ b. Install a specific version using the version string from the second column,
212+ for example, `5:18.09.1~3-0~debian-stretch `.
258213
259214 ```bash
260215 $ sudo apt-get install docker-ce=<VERSION_STRING>
261216 ```
262217
263- The Docker daemon starts automatically.
264-
2652184. Verify that Docker CE is installed correctly by running the `hello-world`
266219 image.
267220
268- **x86_64**:
269-
270221 ```bash
271222 $ sudo docker run hello-world
272223 ```
273224
274- **armhf**:
275-
276- ```bash
277- $ sudo docker run armhf/hello-world
278- ```
279-
280225 This command downloads a test image and runs it in a container. When the
281226 container runs, it prints an informational message and exits.
282227
283228Docker CE is installed and running. The `docker` group is created but no users
284- are added to it. You need to use `sudo` to run Docker
285- commands. Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow
229+ are added to it. You need to use `sudo` to run Docker commands.
230+ Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow
286231non-privileged users to run Docker commands and for other optional configuration
287- steps. For Raspbian, you can optionally
288- [install Docker Compose for Raspbian](#install-docker-compose-for-raspbian).
232+ steps.
289233
290234#### Upgrade Docker CE
291235
@@ -299,10 +243,10 @@ If you cannot use Docker's repository to install Docker CE, you can download the
299243` .deb` file for your release and install it manually. You need to download
300244a new file each time you want to upgrade Docker.
301245
302- 1. Go to ` {{ download-url-base }}/dists/` ,
303- choose your Debian version, browse to ` pool/stable/` , choose
304- ` amd64 ` , ` armhf` , or ` arm64` and download the ` .deb` file for the Docker CE version you
305- want to install.
246+ 1. Go to [ ` {{ download-url-base }}/dists/` ]({{ download-url-base }}/dists/){: target= " _blank " class= " _ " } ,
247+ choose your Debian version, browse to ` pool/stable/` , choose ` amd64 ` ,
248+ ` armhf` , or ` arm64` and download the ` .deb` file for the Docker CE version
249+ you want to install.
306250
307251 > ** Note** : To install an ** edge** package, change the word
308252 > ` stable` in the URL to ` edge` .
@@ -328,37 +272,18 @@ a new file each time you want to upgrade Docker.
328272 container runs, it prints an informational message and exits.
329273
330274Docker CE is installed and running. The ` docker` group is created but no users
331- are added to it. You need to use ` sudo` to run Docker
332- commands. Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
275+ are added to it. You need to use ` sudo` to run Docker commands.
276+ Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
333277to allow non-privileged users to run Docker commands and for other optional
334- configuration steps. For Raspbian, you can optionally
335- [install Docker Compose for Raspbian](# install-docker-compose-for-raspbian).
278+ configuration steps.
336279
337280# ### Upgrade Docker CE
338281
339- To upgrade Docker, download the newer package file and repeat the
282+ To upgrade Docker CE , download the newer package file and repeat the
340283[installation procedure](# install-from-a-package), pointing to the new file.
341284
342285{% include install-script.md %}
343286
344- # # Install Docker Compose for Raspbian
345-
346- You can install Docker Compose using ` pip` :
347-
348- ` ` ` bash
349- $ sudo pip install docker-compose
350- ` ` `
351-
352- [Hypriot](https://hypriot.com/){: target=" _blank" class=" _" } provides a static
353- binary of ` docker-compose` for Raspbian. It may not always be up to date, but if
354- space is at a premium, you may find it useful. To use it, first follow Hypriot' s
355- [instructions for setting up the repository](https://blog.hypriot.com/post/your-number-one-source-for-docker-on-arm/){: target="_blank" class="_" },
356- then run the following command:
357-
358- ```bash
359- sudo apt-get install docker-compose
360- ```
361-
362287# # Uninstall Docker CE
363288
3642891. Uninstall the Docker CE package:
@@ -380,5 +305,4 @@ You must delete any edited configuration files manually.
380305# # Next steps
381306
382307- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
383-
384308- Continue with the [User Guide](/engine/userguide/index.md).
0 commit comments