How to Install Docker Desktop on Debian 12 (Bookworm)

Get Docker Desktop up and running on Debian 12 with our detailed and easy-to-follow guide. Step-by-step instructions tailored for Bookworm.

Docker Desktop is an intuitive and powerful GUI application that makes it easier to create, manage, and deploy Docker containers on systems with desktop environments.

It integrates Docker Engine with a user-friendly interface and additional features that greatly enhance the development experience and speed up the container’s deployment.

At the same time, thanks to its exceptional stability and reliability, Debian is one of the best development platforms available.

That’s why this guide will walk you through installing Docker Desktop on Debian 12 (Bookworm), transforming it into a superb development environment for your container-based projects.

System Requirements

To install Docker Desktop successfully on Debian 12, your host must match the following requirements:

  • 64-bit kernel and CPU support for virtualization.
  • At least 4 GB of RAM.
  • KVM virtualization support.
  • QEMU must be version 5.2 or newer.
  • A desktop environment such as KDE, GNOME, or MATE, with system tray support.

Be aware that Docker Desktop uses the system tray. Unfortunately, the GNOME environment does not support tray icons. You need to install a GNOME extension such as Tray Icons: Reloaded or AppIndicator to enable this functionality.

In addition, it is important to understand that Docker Desktop runs a Virtual Machine that creates its own Docker context. In other words, containers deployed on your Linux host before installing Docker Desktop will not be available in the app.

Step 1: Add Official Docker Repository

I’ll clarify – to install Docker Desktop on Debian 12, you essentially need to install a single DEB package. But, if you quickly download and try to install it without first adding a Docker repository to your system, you’ll encounter an error due to missing dependencies. Specifically, the error states, “docker-desktop : Depends: docker-ce-cli but it is not installable.”

Unmet dependencies error.
Unmet dependencies error.

In other words, Docker Desktop needs the “docker-ce-cli” package installed on your Debian 12 or available in its repositories. So, the first thing we’ll do is add the official Docker repositories to your system. This way, when we install Docker Desktop, all the necessary package dependencies will be met.

Run the commands in the order shown below to add the Docker repository to your Bookworm installation.

sudo apt install apt-transport-https ca-certificates curl gnupg
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker.gpg] https://download.docker.com/linux/debian bookworm stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullCode language: Bash (bash)
Add the official Docker repositories to Debian 12.
Add the official Docker repositories to Debian 12.

Then, refresh the repository index. The command output will show that the Docker repo is ready for use on your system.

sudo apt updateCode language: Bash (bash)
Refreshing package base.
Refreshing package base.

Step 2: Download Docker Desktop

Now point your browser to this address and click the “DEB package” button to download the Docker Desktop installation package for Debian 12.

Download the Docker Desktop installation package for Debian 12.
Download the Docker Desktop installation package for Debian 12.

Step 3: Install Docker Desktop on Debian 12

So, everything is ready. The last step is to install the DEB file we downloaded. To do this, use the command below, but remember to change the file path if you downloaded it to a different folder on your Debian 12 system.

sudo apt install ./Downloads/docker-desktop-amd64.debCode language: Bash (bash)
Install Docker Desktop on Debian 12 (Bookworm).
Install Docker Desktop on Debian 12 (Bookworm).

Wait for the necessary packages to be downloaded and installed; the process will not take more than a minute.

Step 4: Run Docker Desktop

Now, use your application launcher and search for โ€œdocker.โ€ When the Docker Desktop icon appears, click to run it.

Run Docker Desktop
Run Docker Desktop

You will be greeted by the “Docker Subscription Service Agreement.” Click the “Accept” button.

Docker Subscription Service Agreement
Docker Subscription Service Agreement

You can log in on the next screen if you have Docker Desktop subscriptions. If not, just click the “Continue without signing in” link.

Choose to login to your Docker Desktop subscription or continue without it.
Choose to login to your Docker Desktop subscription or continue without it.

We’re almost set. Docker has a quick survey to learn more about its users. You can participate by answering it brieflyย or clicking the “Skip survey” button.

Welcome Survey
Welcome Survey

And just like that, you’ve successfully installed Docker Desktop on your Debian 12 system, which rises before you in all its glory. Congratulations! Additionally, you can manage the application through the system tray icon.

Docker Desktop successfully installed, up & running on Debian 12.
Docker Desktop successfully installed, up & running on Debian 12.

So, what are you waiting for? With Docker Desktop’s excellent graphical interface, you’re all set up and ready to start containerizing your ideas quickly and easily.

Running containers using Docker Desktop on Debian 12.
Running containers using Docker Desktop on Debian 12.

Lastly, to have Docker Desktop automatically start when you log in, go to the Docker Desktop โ€œSettingsโ€ -> โ€œGeneralโ€ and mark the โ€œStart Docker Desktop when you log in to your computerโ€ checkbox. Then, confirm by pressing the โ€œApply & restartโ€ button.

Set Docker Desktop to automatically start when you log in.
Set Docker Desktop to automatically start when you log in.

Bottom Line

This guide provides a comprehensive and user-friendly pathway to successfully install and configure Docker Desktop on Debian 12 (Bookworm). Following the step-by-step instructions, you should have a fully operational Docker environment ready to support your development needs.

For more in-depth knowledge about using Docker, visit its documentation or navigate to the official Docker Desktop manuals.

Additionally, if you want to go with the full command-line approach, our guide on installing Docker on Debian 12 will greatly help you get started.

Thanks for using our guide! Feel free to share your thoughts in the comments section below.

Bobby Borisov

Bobby Borisov

Bobby, an editor-in-chief at Linuxiac, is a Linux professional with over 20 years of experience. With a strong focus on Linux and open-source software, he has worked as a Senior Linux System Administrator, Software Developer, and DevOps Engineer for small and large multinational companies.

Think You're an Ubuntu Expert? Let's Find Out!

Put your knowledge to the test in our lightning-fast Ubuntu quiz!
Ten questions to challenge yourself to see if you're a Linux legend or just a penguin in the making.

1 / 10

Ubuntu is an ancient African word that means:

2 / 10

Who is the Ubuntu's founder?

3 / 10

What year was the first official Ubuntu release?

4 / 10

What does the Ubuntu logo symbolize?

5 / 10

What package format does Ubuntu use for installing software?

6 / 10

When are Ubuntu's LTS versions released?

7 / 10

What is Unity?

8 / 10

What are Ubuntu versions named after?

9 / 10

What's Ubuntu Core?

10 / 10

Which Ubuntu version is Snap introduced?

The average score is 68%