TL;DR
To install Docker on Debian, you can follow these steps:
- Update the package lists to ensure you have the latest available versions:
$ sudo apt update - Upgrade the installed packages to their latest versions for better compatibility and security:
$ sudo apt upgrade - Install the necessary packages to enable HTTPS access, which is required to securely communicate with Docker repositories:
$ sudo apt install apt-transport-https ca-certificates curl software-properties-common - Add Docker’s official GPG key to verify the integrity and authenticity of the downloaded Docker packages
: $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg - Add the Docker repository to Debian’s APT sources and update the package lists, allowing the system to recognize and fetch Docker packages:
$ echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null && sudo apt update - Finally, install Docker, the containerization platform, along with its necessary components:
$ sudo apt install docker-ce docker-ce-cli containerd.io
To effectively manage Docker on Debian, run it as a non-root user, check the Docker version and system status, and validate the installation by running a sample container. Addressing common errors such as connection issues, permissions, package availability, command not found, and socket access will ensure a smooth installation and usage experience with Docker on Debian.
Read the guide below to learn the step-by-step method to install Docker on Debian and common errors that can occur, and how to troubleshoot them.
Docker is an open-source platform that enables developers to package and distribute applications as self-contained containers. These containers encapsulate the application code, along with all its dependencies, into a single, portable unit. With Docker, you can easily deploy applications across different environments without worrying about compatibility issues or system dependencies. In this comprehensive guide, I will walk you through the process to install Docker on Debian, a highly popular and versatile Linux distribution. I will also discuss common errors that can occur when installing and using docker.
How to Install Docker on Debian
To install Docker on Debian, your system needs to meet the following requirements: Debian 9 (Stretch) or newer as the operating system, an x86-64 (64-bit) processor architecture, a Linux kernel version of 3.10 or newer, at least 2 GB of available memory (RAM), and sufficient disk space to accommodate Docker images and containers. To install Docker via the Docker repository, follow these steps:
- Open a Terminal window from the application menu.
- Run the following command to update the package lists:
<strong>$ sudo apt update</strong>- This command will update the package lists to ensure you have the latest available versions.
- Once the package lists are updated, upgrade the installed packages to their latest versions:
<strong>$ sudo apt upgrade</strong>- During the upgrade process, you might be prompted to confirm package updates. Enter Y to proceed with the upgrades.
- Install the necessary packages to allow apt to use a repository over HTTPS:
<strong>$ sudo apt install apt-transport-https ca-certificates curl software-properties-common</strong>- This command installs the required packages to securely communicate with repositories over HTTPS.
- Add Docker’s official GPG key by running the command:
<strong>$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg</strong>- This command adds Docker’s GPG key to ensure the integrity and authenticity of the downloaded packages.
- To Add the Docker repository to Debian’s APT sources execute the command:
<strong>$ echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null</strong>- This command adds the Docker repository to your system’s APT sources, allowing you to install Docker.
- Update the package lists to include the Docker repository:
<strong>$ sudo apt update</strong>- This command updates the package lists to include the Docker repository you added in the previous step.
- Finally, install Docker using the following command:
<strong>$ sudo apt install docker-ce docker-ce-cli containerd.io</strong>- This command installs Docker and its dependencies on your Debian system.
Configuration of Docker on Debian
After successfully installing Docker on Debian, there are a few post-installation steps to ensure optimal usage and security. By managing Docker as a non-root user, configuring network settings and firewalls, and verifying the installation, you can create a secure and efficient environment for deploying and managing containerized applications.
1. Managing Docker as a Non-Root User
Running Docker as a non-root user is recommended to enhance security and prevent unauthorized access to sensitive system resources. To manage Docker as a non-root user, add your user to the docker group using the following command:
<strong><code>$ sudo usermod -aG docker $USER</code></strong>Log out of your session and log back in to apply the group changes.
2. Checking Docker Version and System Status
Verifying the Docker version and system status is crucial to ensure the correct installation and functioning of Docker on Debian.
- To check the installed Docker version, open a Terminal and run the following command:
<strong>$ docker --version</strong>- The command will display the installed docker version.
- Additionally, you can check the running status of Docker and obtain system information using the following command:
<strong>$ docker info</strong>- The output will be:
3. Running a Sample Docker Container
To validate the Docker installation and familiarize yourself with basic container management, you can run a sample Docker container. Follow these steps to run a simple Hello, World! container:
- Open a Terminal and execute the following command: