Install Docker CE on Ubuntu
warning: Don't install Docker CE directly using apt without configuring Docker APT source.
Docker CE supports Ubuntu versions:
- Disco 19.04
- Cosmic 18.10
- Bionic 18.04 (LTS)
- Xenial 16.04 (LTS)
Docker CE can be installed on x86 platform or ARM. In Ubuntu distributions, LTS (Long-Term-Support) will get 5 years updating support, distributions like this will be stable. Therefore, LTS version is recommended in production environment.
Uninstall old version
Old version of Docker is called
docker-engine. Use the following command to uninstall the old version:
$ sudo apt-get remove docker \ docker-engine \ docker.io
Use APT to install
apt source uses HTTPS to ensure that software downloads are not tampered with. Therefore, we need to add software packages and CA certificates that are transmitted using HTTPS first.
$ sudo apt-get update $ sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ software-properties-common
If you are in China, it is strongly recommended to use chinese sources. The official sources are in the comments.
In order to confirm the validity of the downloaded package, we need to add the
GPG key of the software source.
$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg | sudo apt-key add - # official # $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Then, we need to add Docker software source to
$ sudo add-apt-repository \ "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu \ $(lsb_release -cs) \ stable" # official # $ sudo add-apt-repository \ # "deb [arch=amd64] https://download.docker.com/linux/ubuntu \ # $(lsb_release -cs) \ # stable"
The above commands will add stable Docker CE APT source. If you need test or nightly version of Docker, you can change the stable to test or nightly.
Install Docker CE
Update apt cache and install
$ sudo apt-get update $ sudo apt-get install docker-ce
Auto install by script
Docker Offical has provided a set of convenient install scripts which can be installed on Ubuntu system for test or dev environments.
$ curl -fsSL get.docker.com -o get-docker.sh $ sudo sh get-docker.sh --mirror Aliyun
Script will make everythings ok and install Edge version of Docker CE for system after this command.
Launcher Docker CE
$ sudo systemctl enable docker $ sudo systemctl start docker
Add docker user group
docker uses Unix socket to communicate with Docker engine default. Only users of
docker groups can communicate Unix socket of Docker engine.
root user is not directly used on Linux systems in general for security. Therefore, it is better to add users who need to use
docker to the
docker user group.
$ sudo groupadd docker
add current user to
$ sudo usermod -aG docker $USER
Exit current terminal and relogin to test.
Test whether Docker is installed correctly
$ docker run hello-world Unable to find image 'hello-world:latest' locally latest: Pulling from library/hello-world d1725b59e92d: Pull complete Digest: sha256:0add3ace90ecb4adbf7777e9aacf18357296e799f81cabc9fde470971e499788 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/
If it shows above message, it means successful installation.
Registry Mirror(In China)
If you pull docker images very slowly, then you can configurate Registry Mirror.