Docker Pull Image From Registry (Docker Hub)

 In this guide, we will discuss the docker command to pull images from the registry (Docker Hub).

Check out all Docker tutorials and guides: Docker Tutorials and Guides

The Basics of Docker Pull

When you want to retrieve an image to run on Docker, you "pull" it from a registry (a collection of repositories). Docker Hub is the most famous public registry, but there are numerous others, and you can even have private registries. 


docker pull [OPTIONS] NAME[:TAG|@DIGEST]

NAME: Name of the image. 

TAG: Specific version of the image. If no TAG is specified, Docker will pull the "latest" version by default. 

DIGEST: A long string representing the image's version. It's a more specific way to identify versions than TAG.

Key Scenarios & Examples 

Pulling the Latest Version of an Image

To pull the latest version of the official nginx image from Docker Hub:

docker pull nginx

To pull the latest version of the official openjdk image from Docker Hub:

docker pull openjdk

Pulling a Specific Image Tag

If you need a particular version of the nginx image, use the TAG. For instance, to pull version 1.19:

docker pull nginx:1.19

Pulling by Digest

If you know the specific digest (usually obtained from a previous pull or push output):

docker pull ubuntu@sha256:a0ee7647e24c8494f1cf6b94f1a3cd127f4d3f1e3c8e4d5701c57d9f861d6b53

Pulling from a Private Registry

Assuming you have already logged in to your private registry:

docker pull

Using Different Registries

Docker defaults to Docker Hub, but if you’re using a different registry, specify the full path. For example, pulling from the Google Container Registry:

docker pull

Behind the Scenes

When you issue a docker pull command: 

  • Docker checks if the image is already present locally. 
  • If not, it communicates with the specified registry. 
  • Docker then downloads each layer of the image. 
  • Image layers are a set of file differences. 
  • By stacking them together, you reproduce the image's file system. 
  • Once all layers are fetched, Docker assembles them to form the complete image. 

Benefits of Docker Pull

Consistency: By pulling images, you ensure that every environment (be it development, staging, or production) uses the exact same software setup. 

Version Control: Using tags or digests, you can pull specific software versions, ensuring compatibility and stability. 

Efficiency: Docker images are designed to be lightweight and fast to pull. You only download the layers you don't already have. 

Quick Tip

To check if an update to an image is available, regularly run the docker pull command. If there are newer layers, Docker will fetch them, ensuring you always have the latest updates and patches.


The docker pull command is fundamental in the Docker universe. By pulling container images, developers and system admins alike ensure that they're using the most up-to-date, secure, and consistent software setups. The next time you’re about to embark on a new project or deploy an app, remember, a docker pull is your first step to containerized success!

Related Docker Image Management Guides