diff --git a/engine/install/debian.md b/engine/install/debian.md index 810a9047a2..0c62456b95 100644 --- a/engine/install/debian.md +++ b/engine/install/debian.md @@ -30,24 +30,25 @@ Raspbian versions: - Raspbian Bullseye 11 (stable) - Raspbian Buster 10 (oldstable) -Docker Engine is compatible with `x86_64` (or `amd64`), `armhf`, and `arm64` +Docker Engine is compatible with x86_64 (or amd64), armhf, and arm64 architectures. ### Uninstall old versions Older versions of Docker went by the names of `docker`, `docker.io`, or -`docker-engine`. Uninstall any such older versions before attempting to install +`docker-engine`, you might also have installations of `containerd` or `runc`. +Uninstall any such older versions before attempting to install a new version: ```console $ sudo apt-get remove docker docker-engine docker.io containerd runc ``` -It's OK if `apt-get` reports that none of these packages are installed. +`apt-get` might report that you have none of these packages installed. Images, containers, volumes, and networks stored in `/var/lib/docker/` aren't automatically removed when you uninstall Docker. If you want to start with a -clean installation, and prefer to clean up any existing data, refer to the +clean installation, and prefer to clean up any existing data, read the [uninstall Docker Engine](#uninstall-docker-engine) section. ## Installation methods @@ -58,16 +59,16 @@ You can install Docker Engine in different ways, depending on your needs: [Docker Desktop for Linux](../../desktop/install/linux-install.md). This is the easiest and quickest way to get started. -- You can also set up and install Docker Engine from +- Set up and install Docker Engine from [Docker's `apt` repository](#install-using-the-repository). - [Install it manually](#install-from-a-package) and manage upgrades manually. -- Using a [convenience scripts](#install-using-the-convenience-script). Only +- Use a [convenience scripts](#install-using-the-convenience-script). Only recommended for testing and development environments. This is the only approach available for Raspbian. -### Install using the repository +### Install using the apt repository {#install-using-the-repository} Before you install Docker Engine for the first time on a new host machine, you need to set up the Docker repository. Afterward, you can install and update @@ -137,7 +138,7 @@ Raspbian.