A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://cloud.google.com/container-registry/docs/pulling-cached-images below:

Pulling cached Docker Hub images | Container Registry documentation

Pulling cached Docker Hub images

Stay organized with collections Save and categorize content based on your preferences.

Container Registry caches frequently-accessed public Docker Hub images on mirror.gcr.io. You can configure the Docker daemon to use a cached public image if one is available, or pull the image from Docker Hub if a cached copy is unavailable.

Google Cloud services such as Cloud Build and Google Kubernetes Engine automatically check for cached images before attempting to pull an image from Docker Hub.

Note: As of November 1, 2020, Docker Hub rate limits apply to unauthenticated or authenticated pull requests on the Docker Free plan. To avoid disruptions and have greater control over your software supply chain, you can migrate your dependencies to Artifact Registry.

Cached images at mirror.gcr.io are:

Configuring the Docker daemon

To configure your Docker daemon to pull images from the Container Registry cache:

CLI
  1. Configure the daemon in one of the following ways:

  2. Restart the Docker daemon.

Docker UI
  1. Open Docker's Preferences menu.
  2. Click Daemon.
  3. Click Advanced. In the JSON field, add a registry-mirrors key with https://mirror.gcr.io as a value:

    {
      "registry-mirrors" : [
        "https://mirror.gcr.io"
      ]
    }
    
  4. Click Apply & Restart.

To verify that the cache is correctly configured, run:

docker system info

The output should include Registry Mirrors, and should look similar to the following:

Containers: 2
 Running: 0
 Paused: 0
 Stopped: 2
Images: 2
Server Version: 17.03.1-ce
Storage Driver: overlay2
 Backing Filesystem: extfs
 Supports d_type: true
 Native Overlay Diff: true
Logging Driver: json-file
...
Registry Mirrors:
 https://mirror.gcr.io
Pulling cached images

Container Registry adds frequently requested images to the cache so they are available for future requests. It also periodically removes images that are no longer requested.

After you configure the Docker daemon to use the Container Registry cache, Docker performs the following steps when you pull a public Docker Hub image with a docker pull command:

  1. The Docker daemon checks the Container Registry cache and fetches the images if it exists. If your daemon configuration includes other Docker mirrors, the daemon checks each one in order for a cached copy of the image.
  2. If the image still isn't found, the Docker daemon fetches the image from the canonical repository on Docker Hub.

Pulling cached images does not count against Docker Hub rate limits. However, there is no guarantee that a particular image will remain cached for an extended period of time. Only obtain cached images on mirror.gcr.io by configuring the Docker daemon. A request to pull directly from mirror.gcr.io will fail if a cached copy of the image does not exist.

What's next

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-07 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["Container Registry caches frequently-accessed public Docker Hub images on `mirror.gcr.io`, improving image pull performance and reliability."],["Google Cloud services automatically check for cached images before pulling from Docker Hub, streamlining workflows within the Google Cloud ecosystem."],["Configuring the Docker daemon to use `mirror.gcr.io` allows it to prioritize pulling images from the cache, falling back to Docker Hub if the image is not found there."],["Pulling images from the Container Registry cache does not count against Docker Hub rate limits, offering a workaround to potential restrictions on the Docker Free plan."],["Cached images are stored in a Google-managed repository, are kept in sync with Docker Hub, and offer greater insulation from Docker Hub outages."]]],[]]


RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4