====== Docker - Images - Pull an Image from the Docker Hub ======

The Docker **pull** command is used for downloading Docker images from the Docker Hub or private registry.

  * By default, it will download the images from the Docker Hub.
  * You will need to specify the name of the private registry if you want to pull from it.

The basic syntax to pull the Docker image from the Docker Hub as shown below:

<code bash>
docker pull [OPTIONS] NAME[:TAG|@DIGEST]
</code>

----

===== Pull Ubuntu 20.04 Image =====

For example, to pull the Ubuntu 20.04 Docker image from the Docker Hub, run the following command:

<code bash>
docker pull ubuntu:20.04
</code>

returns:

<code bash>
20.04: Pulling from library/ubuntu
6a5697faee43: Pull complete 
ba13d3bc422b: Pull complete 
a254829d9e55: Pull complete 
Digest: sha256:fff16eea1a8ae92867721d90c59a75652ea66d29c05294e6e2f898704bdb8cf1
Status: Downloaded newer image for ubuntu:20.04
docker.io/library/ubuntu:20.04
</code>

----

===== List downloaded Docker images =====

<code bash>
docker images
</code>

returns

<code bash>
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
ubuntu              20.04               d70eaf7277ea        12 days ago         72.9MB
</code>