docs/debian.md at c8d957c9a9148fa49f61f94a23d4b60ddd15dcf7

4.1 KiB

Raw Blame History

description

keywords

title

toc_max

aliases

Instructions for installing Docker Desktop on Debian

debian, install, uninstall, upgrade, update, linux, desktop, docker desktop, docker desktop for linux, dd4l

Install Docker Desktop on Debian

/desktop/linux/install/debian/

This page contains information on how to install, launch, and upgrade Docker Desktop on a Debian distribution.

{{< button text="DEB package" url="https://desktop.docker.com/linux/main/amd64/docker-desktop-4.22.0-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64" >}}

For checksums, see Release notes

Prerequisites

To install Docker Desktop successfully, you must:

Meet the system requirements.
Have a 64-bit version of Debian 11.
Uninstall the tech preview or beta version of Docker Desktop for Linux. Run:
```
$ sudo apt remove docker-desktop
```
For a complete cleanup, remove configuration and data files at $HOME/.docker/desktop, the symlink at /usr/local/bin/com.docker.cli, and purge the remaining systemd service files.
```
$ rm -r $HOME/.docker/desktop
$ sudo rm /usr/local/bin/com.docker.cli
$ sudo apt purge docker-desktop
```
Note

If you have installed the Docker Desktop for Linux tech preview or beta version, you need to remove all files that were generated by those packages (eg. ~/.config/systemd/user/docker-desktop.service, ~/.local/share/systemd/user/docker-desktop.service).
For a Gnome Desktop environment, you must also install AppIndicator and KStatusNotifierItem Gnome extensions.
For non-Gnome Desktop environments, gnome-terminal must be installed:
```
$ sudo apt install gnome-terminal
```

Install Docker Desktop

Recommended approach to install Docker Desktop on Debian:

Set up Docker's package repository.
Download latest DEB package.
Install the package with apt as follows:

$ sudo apt-get update
$ sudo apt-get install ./docker-desktop-<version>-<arch>.deb

Note

At the end of the installation process, apt displays an error due to installing a downloaded package. You can ignore this error message.
N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

There are a few post-install configuration steps done through the post-install script contained in the deb package.

The post-install script:

Sets the capability on the Docker Desktop binary to map privileged ports and set resource limits.
Adds a DNS name for Kubernetes to /etc/hosts.
Creates a symlink from /usr/local/bin/com.docker.cli to /usr/bin/docker. This is because the classic Docker CLI is installed at /usr/bin/docker. The Docker Desktop installer also installs a Docker CLI binary that includes cloud-integration capabilities and is essentially a wrapper for the Compose CLI, at/usr/local/bin/com.docker.cli. The symlink ensures that the wrapper can access the classic Docker CLI.

Launch Docker Desktop

Upgrade Docker Desktop

Once a new version for Docker Desktop is released, the Docker UI shows a notification. You need to download the new package each time you want to upgrade Docker Desktop and run:

$ sudo apt-get install ./docker-desktop-<version>-<arch>.deb

Next steps

Take a look at the Get started training modules to learn how to build an image and run it as a containerized application.
Explore Docker Desktop and all its features.
Review the topics in Develop with Docker to learn how to build new applications using Docker.

4.1 KiB Raw Blame History