Ubuntu Docker installation

Docker Engine-Community supports the following Ubuntu versions:

Xenial 16.04 (LTS)
Bionic 18.04 (LTS)
Cosmic 18.10
Disco 19.04
Other updated versions...

Docker Engine-Community supports x86_64 (or amd64) armhf, arm64, arm32 (manual installation is required), s390x (IBM Z), and ppc64le (IBM Power) architecture.

1 Use the official installation script to automatically install

The installation command is as follows:

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

You can also use the domestic daocloud one-click installation command:

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

2 Manual installation

2.1 Uninstall the old version

The old version of Docker is called docker, docker.io or docker-engine. If they are already installed, uninstall them:

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

Currently called the Docker Engine-Community package docker-ce.

Install Docker Engine-Community, the following two methods are introduced.

2.2 Install using Docker warehouse

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

2.2.1 Set up warehouse

Update the apt package index.

sudo apt-get update

Install the apt dependency package to get the warehouse via HTTPS:

sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

Add Docker's official GPG key:

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

9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 By searching the last 8 characters of the fingerprint, verify that you now have a fingerprint key.

sudo apt-key fingerprint 0EBFCD88

pub rsa4096 2017-02-22 [SCEA]
9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
uid [ unknown] Docker Release (CE deb) <[email protected]>
sub rsa4096 2017-02-22 [S]

Use the following instructions to set up a stable version of the warehouse

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

2.2.2 Install Docker Engine-Community

Update the apt package index.

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, please list the available versions in the repository and choose an installation. List the versions available in your warehouse:

 apt-cache madison docker-ce

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

Use the version string in the second column to install a specific version, such as 5:18.09.1~3-0~ubuntu-xenial.

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 print out the following information, the installation is successful:

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/

3 Install using Shell script

Docker provides convenient scripts on get.docker.com and test.docker.com to quickly install the edge version and test version of Docker Engine-Community. The source code of the script is in the docker-install repository. It is not recommended to use these scripts in a production environment. Before using them, you should understand the potential risks:

The script needs to be run as root or have sudo privileges. Therefore, you should carefully check and review the script before running it.
These scripts try to detect the Linux distribution and version, and configure the package management system for you. In addition, the script does not allow you to customize any installation parameters. From the perspective of Docker or your own organization's guidelines and standards, this may result in unsupported configurations.
These scripts will install all the dependencies and recommendations of the package manager without confirmation. This may install a large number of packages, depending on the current configuration of the host.
The script does not provide an option to specify which version of Docker to install, but instead installs the latest version released in the edge channel.
If you have installed Docker on the host using other mechanisms, do not use convenience scripts.

This example uses the script on get.docker.com to install the latest version of Docker Engine-Community on Linux. To install the latest test version, use test.docker.com instead. In each of the following commands, replace every occurrence of get with test.

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh

If you want to use Docker as a non-root user, you should consider adding users to the docker group in a way similar to the following:

$ sudo usermod -aG docker your-user