@@ -27,18 +27,15 @@ and distributions for different Docker editions, see
27
27
To install Docker CE, you need the 64-bit version of one of these Debian or
28
28
Raspbian versions:
29
29
30
- - Buster 10 (Docker CE 17.11 Edge only)
30
+ - Buster 10
31
31
- Stretch 9 (stable) / Raspbian Stretch
32
- - Jessie 8 (LTS) / Raspbian Jessie
33
- - Wheezy 7.7 (LTS)
34
32
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.
37
34
38
35
### Uninstall old versions
39
36
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:
42
39
43
40
``` bash
44
41
$ 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.
49
46
The contents of ` /var/lib/docker/ ` , including images, containers, volumes, and
50
47
networks, are preserved. The Docker CE package is now called ` docker-ce ` .
51
48
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
-
66
49
## Install Docker CE
67
50
68
51
You can install Docker CE in different ways, depending on your needs:
@@ -94,7 +77,7 @@ from the repository.
94
77
95
78
#### Set up the repository
96
79
97
- {% assign download-url-base = ' https://download.docker.com/linux/debian ' %}
80
+ {% assign download-url-base = " https://download.docker.com/linux/debian " %}
98
81
99
82
1 . Update the ` apt ` package index:
100
83
@@ -104,40 +87,19 @@ from the repository.
104
87
105
88
2. Install packages to allow ` apt` to use a repository over HTTPS:
106
89
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
-
126
90
` ` ` bash
127
91
$ 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
132
97
` ` `
133
98
134
- < /div>
135
- < /div> < ! -- tab-content -->
136
-
137
99
3. Add Docker' s official GPG key:
138
100
139
101
```bash
140
- $ curl -fsSL {{ download-url-base}}/gpg | sudo apt-key add -
102
+ $ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add -
141
103
```
142
104
143
105
Verify that you now have the key with the fingerprint
@@ -160,7 +122,7 @@ from the repository.
160
122
word `stable` in the commands below.
161
123
162
124
> **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 `.
164
126
165
127
To also add the **edge** repository, add `edge` after `stable` on the last
166
128
line of the command.
@@ -184,34 +146,25 @@ from the repository.
184
146
<div id="armhf_repo" class="tab-pane fade" markdown="1">
185
147
186
148
```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"
190
153
```
191
154
192
155
</div>
193
156
<div id="arm64_repo" class="tab-pane fade" markdown="1">
194
157
195
158
```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"
199
163
```
200
164
201
165
</div>
202
166
</div> <!-- tab-content -->
203
167
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
-
215
168
> **Note**: Starting with Docker 17.06, stable releases are also pushed to
216
169
> the **edge** and **test** repositories.
217
170
@@ -248,44 +201,35 @@ from the repository.
248
201
```bash
249
202
$ apt-cache madison docker-ce
250
203
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
+ ...
252
209
```
253
210
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 `.
258
213
259
214
```bash
260
215
$ sudo apt-get install docker-ce=<VERSION_STRING>
261
216
```
262
217
263
- The Docker daemon starts automatically.
264
-
265
218
4. Verify that Docker CE is installed correctly by running the `hello-world`
266
219
image.
267
220
268
- **x86_64**:
269
-
270
221
```bash
271
222
$ sudo docker run hello-world
272
223
```
273
224
274
- **armhf**:
275
-
276
- ```bash
277
- $ sudo docker run armhf/hello-world
278
- ```
279
-
280
225
This command downloads a test image and runs it in a container. When the
281
226
container runs, it prints an informational message and exits.
282
227
283
228
Docker 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
286
231
non-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.
289
233
290
234
#### Upgrade Docker CE
291
235
@@ -299,10 +243,10 @@ If you cannot use Docker's repository to install Docker CE, you can download the
299
243
` .deb` file for your release and install it manually. You need to download
300
244
a new file each time you want to upgrade Docker.
301
245
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.
306
250
307
251
> ** Note** : To install an ** edge** package, change the word
308
252
> ` stable` in the URL to ` edge` .
@@ -328,37 +272,18 @@ a new file each time you want to upgrade Docker.
328
272
container runs, it prints an informational message and exits.
329
273
330
274
Docker 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)
333
277
to 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.
336
279
337
280
# ### Upgrade Docker CE
338
281
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
340
283
[installation procedure](# install-from-a-package), pointing to the new file.
341
284
342
285
{% include install-script.md %}
343
286
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
-
362
287
# # Uninstall Docker CE
363
288
364
289
1. Uninstall the Docker CE package:
@@ -380,5 +305,4 @@ You must delete any edited configuration files manually.
380
305
# # Next steps
381
306
382
307
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
383
-
384
308
- Continue with the [User Guide](/engine/userguide/index.md).
0 commit comments