Get Started
About Docker Apply custom metadata Docker Deprecated Features Understand the architecture
Image management
Using certificates for repository client verification Run a local registry mirror
Docker run reference Dockerfile reference Remote API client libraries docker.io accounts API Docker Trusted Registry

pull

Usage: docker pull [OPTIONS] NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG]

Pull an image or a repository from the registry

  -a, --all-tags=false          Download all tagged images in the repository
  --disable-content-trust=true  Skip image verification
  --help=false                  Print usage

Most of your images will be created on top of a base image from the Docker Hub registry.

Docker Hub contains many pre-built images that you can pull and try without needing to define and configure your own.

It is also possible to manually specify the path of a registry to pull from. For example, if you have set up a local registry, you can specify its path to pull from it. A repository path is similar to a URL, but does not contain a protocol specifier (https://, for example).

To download a particular image, or set of images (i.e., a repository), use docker pull:

$ docker pull debian
# will pull the debian:latest image and its intermediate layers
$ docker pull debian:testing
# will pull the image named debian:testing and any intermediate
# layers it is based on.
$ docker pull debian@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
# will pull the image from the debian repository with the digest
# sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
# and any intermediate layers it is based on.
# (Typically the empty `scratch` image, a MAINTAINER layer,
# and the un-tarred base).
$ docker pull --all-tags centos
# will pull all the images from the centos repository
$ docker pull registry.hub.docker.com/debian
# manually specifies the path to the default Docker registry. This could
# be replaced with the path to a local registry to pull from another source.
# sudo docker pull myhub.com:8080/test-image
On this page:
Nov 3, 2015 at 7:59pm (PST) { "docker/compose": { "ref": "docs", "repos": [ "git@github.com:docker/compose.git" ], "sha": "9c8173dbfda93baef214359991b6a8a54172f6ae" }, "docker/docker-hub": { "ref": "master", "repos": [ "git@github.com:docker/hub2-demo.git" ], "sha": "4b2e522c81c860d63b126342a6b981ac0ff1605c" }, "docker/docker-trusted-registry": { "ref": "docs", "repos": [ "git@github.com:docker/dhe-deploy.git" ], "sha": "b8988465878952f2e2c2472e8fc5fd35e5975fbf" }, "docker/docs-base": { "ref": "hugo-github-linking", "repos": [ "git@github.com:docker/docs-base.git" ], "sha": "dc98c0381a6cc311c9e3189dc78a3c7e62e5a205" }, "docker/engine": { "ref": "master", "repos": [ "git@github.com:docker/docker.git" ], "sha": "474b16af8ecfe94ec635dfac60025348d3186aa3" }, "docker/machine": { "ref": "master", "repos": [ "git@github.com:docker/machine.git" ], "sha": "786437901c0c883ecb59c1e0531654c1d89b326d" }, "docker/opensource": { "ref": "master", "repos": [ "git@github.com:docker/opensource.git" ], "sha": "0cd99bcdd876ca0293d8944980c79f32064b6354" }, "docker/registry": { "ref": "master", "repos": [ "git@github.com:docker/distribution.git" ], "sha": "a9da0e510032314910b5405acc50873ab2fa2e5a" }, "docker/swarm": { "ref": "master", "repos": [ "git@github.com:docker/swarm.git" ], "sha": "087e2452f3ec474f112b4e5b8c52b8dacb5751be" }, "docker/tutorials": { "ref": "master", "repos": [ "git@github.com:docker/tutorials.git" ], "sha": "cb55d4de0df55e22f443aac664d66f092f06c56b" }, "docs.docker.com": { "ref": "refs/heads/1-9-release", "repos": [ "git@github.com:moxiegirl/docs.docker.com.git", "git@github.com:docker/docs.docker.com.git" ], "sha": "5878eae5de6f012c67a2a4772327c9948274c351" }, "kitematic/kitematic": { "ref": "master", "repos": [ "git@github.com:kitematic/kitematic.git" ], "sha": "e533ed35d2eab31ce528675b0665f97516b4147b" } }