diff --git a/engine/install/debian.md b/engine/install/debian.md index b5c80eba6500..73f26f0a5c20 100644 --- a/engine/install/debian.md +++ b/engine/install/debian.md @@ -19,8 +19,7 @@ To get started with Docker Engine on Debian, make sure you ### OS requirements -To install Docker Engine, you need the 64-bit version of one of these Debian or -Raspbian versions: +To install Docker Engine, you need one of these Debian or Raspbian versions: - Debian Bullseye 11 (testing) - Debian Buster 10 (stable) @@ -50,7 +49,7 @@ You can install Docker Engine 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, except for Raspbian. + recommended approach. - Some users download the DEB package and [install it manually](#install-from-a-package) and manage @@ -59,7 +58,6 @@ You can install Docker Engine in different ways, depending on your needs: - In testing and development environments, some users choose to use automated [convenience scripts](#install-using-the-convenience-script) to install Docker. - This is currently the only approach for Raspbian. ### Install using the repository @@ -67,14 +65,9 @@ Before you install Docker Engine for the first time on a new host machine, you n to set up the Docker repository. Afterward, you can install and update Docker from the repository. -> **Raspbian users cannot use this method!** -> -> For Raspbian, installing using the repository is not yet supported. You must -> instead use the [convenience script](#install-using-the-convenience-script). - #### Set up the repository -{% assign download-url-base = "https://download.docker.com/linux/debian" %} +{% assign download-url-base = "https://download.docker.com/linux" %} 1. Update the `apt` package index and install packages to allow `apt` to use a repository over HTTPS: @@ -93,7 +86,7 @@ from the repository. 2. Add Docker's official GPG key: ```console - $ curl -fsSL {{ download-url-base }}/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg + $ curl -fsSL {{ download-url-base }}/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg ``` 3. Use the following command to set up the **stable** repository. To add the @@ -104,39 +97,35 @@ from the repository. > Debian distribution, such as `helium`. Sometimes, in a distribution > like BunsenLabs Linux, you might need to change `$(lsb_release -cs)` > to your parent Debian distribution. For example, if you are using - > `BunsenLabs Linux Helium`, you could use `stretch`. Docker does not offer any guarantees on untested + > `BunsenLabs Linux Helium`, you could use `stretch`. Docker does not offer any guarantees on untested > and unsupported Debian distributions. + > **Note**: The `dpkg --print-architecture` sub-command below returns the native + > package architecture of your Debian distribution, such as `arm64`. If you want to install + > Docker for a foreign package architecture, replace `$(dpkg --print-architecture)` + > with e.g. `armhf` or `arm64`. +
-
+
```console $ echo \ - "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] {{ download-url-base }} \ - $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null + "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \ + {{ download-url-base }}/debian \ + $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ```
-
+
```console $ echo \ - "deb [arch=armhf signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] {{ download-url-base }} \ - $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null - ``` - -
-
- - ```console - $ echo \ - "deb [arch=arm64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] {{ download-url-base }} \ - $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null + "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] {{ download-url-base }}/raspbian \ + $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ```
@@ -144,8 +133,6 @@ from the repository. #### Install Docker Engine -This procedure works for Debian on `x86_64` / `amd64`, `armhf`, `arm64`, and Raspbian. - 1. Update the `apt` package index, and install the _latest version_ of Docker Engine and containerd, or go to the next step to install a specific version: @@ -169,14 +156,14 @@ This procedure works for Debian on `x86_64` / `amd64`, `armhf`, `arm64`, and Ras ```console $ apt-cache madison docker-ce - 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 + docker-ce | 5:20.10.3~3-0~debian-buster | {{ download-url-base }}/debian buster/stable amd64 Packages + docker-ce | 5:20.10.2~3-0~debian-buster | {{ download-url-base }}/debian buster/stable amd64 Packages + docker-ce | 18.06.3~ce~3-0~debian | {{ download-url-base }}/debian buster/stable amd64 Packages + docker-ce | 18.06.2~ce~3-0~debian | {{ download-url-base }}/debian buster/stable amd64 Packages ``` b. Install a specific version using the version string from the second column, - for example, `5:18.09.1~3-0~debian-stretch `. + for example, `5:20.10.3~3-0~debian-buster`. ```console $ sudo apt-get install docker-ce= docker-ce-cli= containerd.io @@ -209,7 +196,7 @@ If you cannot use Docker's repository to install Docker Engine, you can download `.deb` file for your release and install it manually. You need to download a new file each time you want to upgrade Docker. -1. Go to [`{{ download-url-base }}/dists/`]({{ download-url-base }}/dists/){: target="_blank" rel="noopener" class="_" }, +1. Go to [`{{ download-url-base }}/debian/dists/`]({{ download-url-base }}/debian/dists/){: target="_blank" rel="noopener" class="_" }, choose your Debian version, then browse to `pool/stable/`, choose `amd64`, `armhf`, or `arm64`, and download the `.deb` file for the Docker Engine version you want to install.