Debian Docker Installation

Debian Docker Installation

Docker supports the following Debian versions.

  • Buster 10
  • Stretch 9 (stable) / Raspbian Stretch

Docker Engine-Community is supported on x86_64 (or amd64) armhf, and arm64 architectures.

Automatically install Docker using the official installation script

The installation command is as follows –

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

You can also use the daocloud one-click install command at –

curl -sSL https://get.daocloud.io/docker | sh

Installing Docker manually

Uninstalling older versions

Older versions of Docker are known as docker, docker.io or docker-engine, and if they are installed, uninstall them at

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

Installing Docker Engine-Community

Installing with a Docker repository

Before installing Docker Engine-Community for the first time on a new host, you need to set up a Docker repository. After that, you can install and update Docker from the repository.

Raspbian users cannot use this method!

For Raspbian, repository installation is not yet supported. You must use a shell script instead.

Set up the repository

Update the apt package index.

$ sudo apt-get update

Install the apt dependency package for accessing the repository via HTTPS.

$ sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg2 \
    software-properties-common

Add the official GPG key for Docker.

$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/debian/gpg | sudo apt-key add -

9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 Verify that you now have the key with the fingerprint by searching for the last 8 characters of the fingerprint.

$ sudo apt-key fingerprint 0EBFCD88

pub   4096R/0EBFCD88 2017-02-22
      Key fingerprint = 9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
uid                  Docker Release (CE deb) <docker@docker.com>
sub   4096R/F273FCD8 2017-02-22

Set up the stable repository using the following command –

$ sudo add-apt-repository \
   "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/debian \
  $(lsb_release -cs) \
  stable"

Installing Docker Engine-Community

Update the apt package index at

$ sudo apt-get update

Install the latest version of Docker Engine-Community and containerd, or go to the next step to install a specific version.

$ sudo apt-get install docker-ce docker-ce-cli containerd.io

To install a specific version of Docker Engine-Community, list the available versions in your repository and select one to install. List the versions available in your repository at:

$ apt-cache madison docker-ce

  docker-ce | 5:18.09.1~3-0~debian-stretch | https://mirrors.ustc.edu.cn/docker-ce/linux/debian stretch/stable amd64 Packages
  docker-ce | 5:18.09.0~3-0~debian-stretch | https://mirrors.ustc.edu.cn/docker-ce/linux/debian stretch/stable amd64 Packages
  docker-ce | 18.06.1~ce~3-0~debian        | https://mirrors.ustc.edu.cn/docker-ce/linux/debian stretch/stable amd64 Packages
  docker-ce | 18.06.0~ce~3-0~debian        | https://mirrors.ustc.edu.cn/docker-ce/linux/debian stretch/stable amd64 Packages
  ...

Install a specific version using the version string in the second column, e.g. 5:18.09.1~3-0~debian-stretch .

$ sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io

To test whether Docker is installed successfully, enter the following command and the installation will be successful if the following message is printed:

$ sudo docker run hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
1b930d010525: Pull complete                                                                                                                                  Digest: sha256:c3b4ada4687bbaa170745b3e4dd8ac3f194ca95b2d0518b417fb47e5879d9b5f
Status: Downloaded newer 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.
    (amd64)
 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 an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

Uninstall Docker

Delete the installation package:

sudo apt-get purge docker-ce

Deleting images, containers, configuration files, etc.

sudo rm -rf /var/lib/docker
Like(1)