Docker

How to Install Docker on Debian 12

Docker is a well-liked and open-source framework that is universally used to develop, run, and ship applications and software in a containerized environment. In a containerized environment, the applications are encapsulated in containers along with required dependencies, packages, and source code. These containers are platform-independent and can be executed and shipped on any system such as Windows, MacOS, Debian, Ubuntu, and so on.

This blog will demonstrate:

How to Install Docker on Debian 12?

Debian is a well-known Linux distribution that consists of free and open-source software and packages. To install Docker on Debian, users are required to have a 64-bit OS of any Debian version such as Debian 12 (Bookworm). To install the Docker on Debian 12, go through the following illustration.

Step 1: Launch “Software & Updates” App

First, launch the “Activity” menu of Debian through the “Window/Super +A” shortcut key. After that, open the “Software & Updates” settings:

Step 2: Enable Search and Download From Internet Options

Mark all the below-highlighted checkboxes under the “Debian Software” menu. Next, choose the “Main server” option from the “Download from” dropdown menu:

Step 3: Launch Debian Terminal

Next, again open the Activity menu and launch the Debian terminal. Users can also use the “CTRL+ALT+T” shortcut key to launch the terminal:

Step 4: Update APT Repository

Next, update the APT official linux repository using the below command:

sudo apt-get update

Step 5: Install Required Dependencies

Install all the required dependencies such as curl and gnupg through the “sudo apt-get install” command:

sudo apt-get install ca-certificates curl gnupg

Step 6: Download Docker GPG Key

Create a new folder, and set the permissions as “0755” code which means this file or folder is executable and readable by others but writable by the user only. For this purpose, run the below command:

sudo install -m 0755 -d /etc/apt/keyrings

Now, download the gpg key for Docker and overwrite it in the “/etc/apt/keyrings/” directory using the “-o” option:

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Step 7: Change the File Permissions

Next, change the gpg file permissions using the “sudo chmod” command. In the below command, “a” is used to grant permission to all users, and “r” is used to make the file readable:

sudo chmod a+r /etc/apt/keyrings/docker.gpg

Step 8: Add Repository to APT Source

Add the updated repository along with the gpg key to the official APT source with the help of the given command:

echo \

"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \

"
$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Now, again execute the “sudo apt-get update” command to update the APT repository:

sudo apt-get update

Step 9: Install Docker, Docker Compose, Buildx Plugin

Install the Docker along with other essential components such as Docker cli, containerd, buildx plugin, and docker compose:

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

The below output confirms that all the above-mentioned components are installed successfully on Debian 12:

Step 10: Check Docker Status

Now, check whether the Docker is running or active on Debian or not using the “systemctl” command:

sudo systemctl is-active docker

Step 11: Run Docker

For verification, fire up the first Docker container by executing “hello-world” Docker image:

sudo docker run hello-world

The below output shows that we have successfully started the Docker container on Debian:

How to Add Docker to User Group in Debian?

In Linux, all docker commands are executable with sudo rights and if users execute them directly without root privileges, they may encounter a “permission denied” error as shown below:

docker ps -a

To resolve the stated error, users are required to add Docker to the root user group. To do so, follow the below instructions.

Step 1: Add Docker to the User Group

To add Docker to the user group, utilize the below command. Here, the “-aG” option is used to append and add the user to supplementary groups:

sudo usermod -aG docker ${USER}

After adding the “docker” user to supplemental groups, reboot the system to implement the changes.

Step 2: User Docker Command Without Sudo Privileges

Now, execute any Docker command without sudo privileges. The below command is used to list down the running containers:

docker ps

The output shows that we have successfully executed the “docker ps” command without root privileges:

Bonus Tip: Uninstall Docker From Debian 12

Sometimes, users are required to uninstall Docker from Debian for different reasons such as to install the latest or stable version of Docker. For this purpose, follow the below instructions and uninstall Docker completely from the Debian system.

Step 1: Uninstall Docker Installed Packages

The “sudo apt-get purge” command is utilized to remove programs along with configuration files. To completely remove Docker from the system, utilize the given command.

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

The above command will remove Docker, Docker CLI, Buildx plugin and Docker compose:

The below output shows that we have successfully removed the Docker from Debian:

Step 2: Remove Stored Containers, Images, and Volumes

Now, remove the directories where Docker images, volume, and containers are stored using the “rm -rf” command:

sudo rm -rf /var/lib/docker

Remove the “containerd” directory that is used to manage the lifecycle of containers and images through Docker daemon as the host system:

sudo rm -rf /var/lib/containerd

That is all about installing and removing the Docker on Debian 12.

Conclusion

To install the Docker on Debian, first, download the Docker official gpg key. After that, add it to the APT source repository. Now, install the Docker and other essential components through the “sudo apt install” command. In order to run the Docker commands without root privileges, add the “docker” to the root user group using the “sudo usermod -aG” command. This blog has illustrated the procedure to install Docker on Debian 12.

About the author

Rafia Zafar

I am graduated in computer science. I am a junior technical author here and passionate about Programming and learning new technologies. I have worked in JAVA, HTML 5, CSS3, Bootstrap, and PHP.