Skip to content

engine: install: debian.md suggest using apt UI #23679

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 12, 2025
Merged

engine: install: debian.md suggest using apt UI #23679

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 11 additions & 12 deletions content/manuals/engine/install/debian.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,10 +71,10 @@ conflicts with the versions bundled with Docker Engine.
Run the following command to uninstall all conflicting packages:

```console
$ for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done
$ sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc podman-docker containerd runc | cut -f1)
Copy link
Contributor

@tianon tianon Nov 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why even filter? Doesn't apt have reasonable behavior when you ask it to remove packages that aren't installed? (I'm sure we've probably discussed this before and I've just forgotten 😅)

Copy link
Contributor Author

@eshattow eshattow Nov 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

all of the apt, apt-get, ... remove package tool actions bail out if a package does not exist. I would be in favor of just making the documentation more instructive "if apt complains that a package does not exist you should remove it from the command and try again". However, as this pull request goes, I remove the scripting of apt-get as it is replaced with apt, the intent is to keep the same errors and information, and at most the user will benefit slightly if they allow sudo to timeout due to slow network access or whatever situation they will just have the one sudo invocation with the update I propose.

```

`apt-get` might report that you have none of these packages installed.
`apt` 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
Expand Down Expand Up @@ -109,8 +109,8 @@ Docker from the repository.

```bash
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL {{% param "download-url-base" %}}/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
Expand All @@ -124,7 +124,7 @@ Docker from the repository.
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt-get update
sudo apt update
```

> [!NOTE]
Expand All @@ -148,7 +148,7 @@ Docker from the repository.
To install the latest version, run:

```console
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
$ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

{{< /tab >}}
Expand All @@ -158,19 +158,18 @@ Docker from the repository.
available versions in the repository:

```console
# List the available versions:
$ apt-cache madison docker-ce | awk '{ print $3 }'
$ apt list --all-versions docker-ce

5:{{% param "docker_ce_version" %}}-1~debian.12~bookworm
5:{{% param "docker_ce_version_prev" %}}-1~debian.12~bookworm
docker-ce/bookworm 5:{{% param "docker_ce_version" %}}-1~debian.12~bookworm <arch>
docker-ce/bookworm 5:{{% param "docker_ce_version_prev" %}}-1~debian.12~bookworm <arch>
...
```

Select the desired version and install:

```console
$ VERSION_STRING=5:{{% param "docker_ce_version" %}}-1~debian.12~bookworm
$ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
$ sudo apt install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
```

{{< /tab >}}
Expand Down Expand Up @@ -284,7 +283,7 @@ To upgrade Docker Engine, download the newer package files and repeat the
1. Uninstall the Docker Engine, CLI, containerd, and Docker Compose packages:

```console
$ sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
$ sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
```

2. Images, containers, volumes, or custom configuration files on your host
Expand Down