Skip to main content

Installation

The following steps are for installing Docker Engine on a Debian system. The instructions are taken from the official documentation.

Install using apt

  1. Set up Docker's Apt repository.
    # Add Docker's official GPG key:
    sudo apt-get update
    sudo apt-get install ca-certificates curl gnupg
    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 a+r /etc/apt/keyrings/docker.gpg
    
    # Add the repository to Apt sources:
    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
    sudo apt-get update
    
  2. Install the Docker packages.
    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    
  3. Test if docker is working by running
    sudo docker run hello-world
    

Post-Installation steps

Make it possible for docker to be run without sudo.

  1. Create the docker group (if necessary).
    sudo groupadd docker
    
  2. Add your user to the docker group.
    sudo usermod -aG docker $USER
    
  3. Log out and log back in. If you are running in a VM you might need to restart the VM.
  4. Verify that docker can be run without sudo.
    docker run hello-world
    

See also