Skip to content

engine: update ubuntu installation instructions to use deb822, apt #23705

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 3 commits into from
Nov 13, 2025
Merged

engine: update ubuntu installation instructions to use deb822, apt #23705

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7894596
engine: use deb822 apt source format in ubuntu install
dvdksn Nov 12, 2025
badf5a8
engine: change apt-get to apt in ubuntu install
dvdksn Nov 12, 2025
556eed6
fix: update apt source filename in ubuntu uninstall
dvdksn Nov 13, 2025
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
37 changes: 20 additions & 17 deletions content/manuals/engine/install/ubuntu.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,10 +88,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 docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done
$ sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)
```

`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 @@ -126,18 +126,22 @@ 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

# Add the repository to Apt sources:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] {{% param "download-url-base" %}} \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: {{% param "download-url-base" %}}
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
```

2. Install the Docker packages.
Expand All @@ -148,7 +152,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 +162,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~ubuntu.24.04~noble
5:{{% param "docker_ce_version_prev" %}}-1~ubuntu.24.04~noble
docker-ce/noble 5:{{% param "docker_ce_version" %}}-1~ubuntu.24.04~noble <arch>
docker-ce/noble 5:{{% param "docker_ce_version_prev" %}}-1~ubuntu.24.04~noble <arch>
...
```

Select the desired version and install:

```console
$ VERSION_STRING=5:{{% param "docker_ce_version" %}}-1~ubuntu.24.04~noble
$ 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 +287,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 All @@ -298,7 +301,7 @@ To upgrade Docker Engine, download the newer package files and repeat the
3. Remove source list and keyrings

```console
$ sudo rm /etc/apt/sources.list.d/docker.list
$ sudo rm /etc/apt/sources.list.d/docker.sources
$ sudo rm /etc/apt/keyrings/docker.asc
```

Expand Down