How to Install Docker on Debian

Docker has revolutionized the way developers build, ship, and run applications. Its containerization technology allows for isolated environments, ensuring consistency across development, testing, and production. For users of the Debian operating system, installing Docker is a straightforward process that unlocks a powerful suite of tools for modern software deployment. This guide will walk you through the recommended steps to get Docker up and running on your Debian system, ensuring a secure and up-to-date installation.

Prerequisites for Docker Installation

Before embarking on the Docker installation journey on Debian, a few preliminary checks and preparations are essential to ensure a smooth and successful deployment. These steps guarantee that your system is ready to host and manage Docker containers effectively.

System Requirements

Docker is designed to be resource-efficient, but certain minimum specifications will enhance performance. While Docker can run on older hardware, a more recent Debian version will generally provide better compatibility and access to the latest features.

• Debian Version: It is highly recommended to use a supported version of Debian. As of recent updates, Debian 10 (Buster), Debian 11 (Bullseye), and Debian 12 (Bookworm) are well-supported. Older versions may not have access to the latest Docker packages or necessary kernel features.
• Hardware:
  • RAM: A minimum of 2GB of RAM is advisable for running a few containers. For more demanding workloads or multiple complex containers, 4GB or more is recommended.
  • CPU: A multi-core processor will significantly improve performance, especially when running multiple containers concurrently.
  • Disk Space: The amount of disk space required depends on the size of your container images and the data they generate. It’s prudent to allocate at least 20-30GB of free space, with more needed for extensive image management or data persistence.

Updating Your Debian System

It’s crucial to ensure your system’s package list and installed packages are up-to-date before proceeding with any new software installation. This helps to prevent conflicts with existing packages and ensures you are installing the latest available versions of dependencies.

1. Update Package Lists:
   Open your terminal and execute the following command to refresh the list of available packages from the repositories:

   sudo apt update
   

2. Upgrade Existing Packages:
   After updating the package lists, it’s a good practice to upgrade all installed packages to their latest versions. This command will upgrade packages that have newer versions available:

   sudo apt upgrade -y
   

   The -y flag automatically answers “yes” to any prompts during the upgrade process.

Removing Old Docker Versions (If Applicable)

If you have previously attempted to install Docker on your Debian system or have installed older versions, it’s essential to remove them to avoid conflicts with the new installation. The Docker package names have evolved over time.

Execute the following commands to uninstall any pre-existing Docker packages:

sudo apt remove docker docker-engine docker.io containerd runc

If you are unsure if these packages are installed, running these commands will simply indicate that they are not present if they are already gone.

Installing Docker Engine on Debian

The recommended method for installing Docker Engine on Debian is by using the official Docker repository. This ensures that you always have access to the latest stable releases and security updates directly from Docker.

Setting Up the Docker Repository

To install Docker from the official repository, you first need to add the repository to your system’s sources list. This involves a few steps:

1. Install Required Packages:
   You’ll need to install packages that allow apt to use a repository over HTTPS.

   sudo apt install ca-certificates curl gnupg
   

2. Add Docker’s Official GPG Key:
   This key is used to verify the integrity and authenticity of the Docker packages.

   sudo install -m 0755 -d /etc/apt/keyrings
   curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
   sudo chmod 644 /etc/apt/keyrings/docker.gpg # Permite la lectura a todos los usuarios
   

3. Set Up the Docker Repository:
   Now, add the Docker repository to your apt sources. You need to specify the Debian version. Replace "$(lsb_release -cs)" with your Debian release codename (e.g., bullseye for Debian 11) if it’s not automatically detected correctly.

   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
   

Installing Docker Engine

With the repository set up, you can now install Docker Engine.

1. Update Package Lists Again:
   After adding the new repository, refresh your apt package lists to include the Docker packages.

   sudo apt update
   

2. Install Docker Engine:
   Install the latest stable version of Docker Engine, containerd, and the Docker Compose plugin.

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

   • docker-ce: This is the Docker Engine itself.
   • docker-ce-cli: This is the command-line interface to interact with Docker.
   • containerd.io: A container runtime.
   • docker-buildx-plugin: Enables advanced build capabilities with BuildKit.
   • docker-compose-plugin: Integrates Docker Compose functionality directly into the Docker CLI.

Verifying Docker Installation

Once the installation is complete, it’s crucial to verify that Docker is running correctly and accessible.

Checking Docker Service Status

The Docker service should start automatically after installation. You can check its status using systemctl.

sudo systemctl status docker

You should see output indicating that the docker.service is active and running. If it’s not running, you can start it with:

sudo systemctl start docker

And enable it to start on boot:

sudo systemctl enable docker

Running the “Hello World” Container

The most common way to test a Docker installation is by running a simple “hello-world” container. This container will download a small image and run it, producing an informational message.

sudo docker run hello-world

If the installation is successful, you will see a message similar to this:

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2023-10-27 10:00:00 UTC | Downloaded image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.

To try something more ambitious, you can run our tutorials:
$ docker run -it ubuntu bash

This output confirms that Docker can download images from Docker Hub and run containers successfully.

Post-Installation Steps and Best Practices

After successfully installing Docker, several post-installation steps and best practices can significantly enhance your experience and security.

Managing Docker as a Non-Root User

By default, the docker command requires sudo privileges. To run Docker commands without sudo, you need to add your user to the docker group.

1. Add User to Docker Group:

   sudo usermod -aG docker $USER
   

   The -aG flags append the user to the specified group. $USER is an environment variable that represents your current username.

2. Apply Group Changes:
   For the group changes to take effect, you need to log out and log back in to your Debian session. Alternatively, you can activate the changes for your current shell session using the newgrp command:

   newgrp docker
   

   After this, you should be able to run docker commands without sudo.

Configuring Docker Daemon

The Docker daemon’s configuration is primarily managed through /etc/docker/daemon.json. This file allows you to customize various aspects of Docker’s behavior, such as storage drivers, network settings, and logging.

Example daemon.json:

{
  "storage-driver": "overlay2",
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "data-root": "/var/lib/docker"
}

• storage-driver: Specifies the storage driver. overlay2 is the recommended and default driver for most Linux systems.
• log-driver: Sets the logging driver for containers. json-file is the default and suitable for most use cases.
• log-opts: Configuration for the log driver, such as maximum log file size and number of files.
• data-root: Specifies the directory where Docker stores its data (images, containers, volumes).

After modifying daemon.json, you must restart the Docker service for the changes to take effect:

sudo systemctl restart docker

Understanding Docker Compose

Docker Compose is a tool for defining and running multi-container Docker applications. It uses a YAML file (docker-compose.yml) to configure your application’s services, networks, and volumes. While the docker-compose-plugin is installed by default with Docker Engine, understanding its usage is key for managing complex applications.

Example docker-compose.yml:

version: '3.8'

services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html

  app:
    build: .
    ports:
      - "5000:5000"
    depends_on:
      - web

To run this application, you would typically navigate to the directory containing the docker-compose.yml file and run:

docker compose up -d

The -d flag runs the containers in detached mode.

Keeping Docker Updated

The Docker project releases frequent updates, including security patches and new features. Regularly updating your Docker installation is crucial for maintaining a secure and efficient environment.

To update Docker to the latest version, simply run:

sudo apt update
sudo apt upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

This command will fetch and install any available updates for the Docker packages from the configured repository.

Conclusion

Installing Docker on Debian is a fundamental step towards embracing containerization for your software development and deployment workflows. By following the recommended steps of setting up the official Docker repository and performing post-installation configurations, you ensure a robust, secure, and up-to-date Docker environment. With Docker Engine, the CLI, and Docker Compose at your disposal, you are well-equipped to build, manage, and deploy applications with unprecedented ease and consistency. This foundational knowledge will empower you to leverage the full potential of container technology on your Debian system.