Sitelet https://github.com/docker/docs/pull/26307
Skip to content

engine/storage/containerd: Document lazy pulling - #26307

Open
vvoland wants to merge 1 commit into
docker:mainfrom
vvoland:lazy-pull
Open

vvoland wants to merge 1 commit into
docker:mainfrom
vvoland:lazy-pull

Conversation

@vvoland

@vvoland vvoland commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

With the nydus, overlaybd, soci, or stargz snapshotter, docker pull skips the content of layers that the snapshotter provides. If that content isn't already stored locally, docker save fails for the image, and docker push can fail too.

Add a "Lazy pulling" section that explains this default, which layers it skips, and its limits. It notes that the default needs no configuration, and that setting the lazy-pull feature overrides it.

Description

Related issues or tickets

Reviews

  • Technical review
  • Editorial review
  • Product review

With the nydus, overlaybd, soci, or stargz snapshotter, docker pull
skips the content of layers that the snapshotter provides. If that
content isn't already stored locally, docker save fails for the image,
and docker push can fail too.

Add a "Lazy pulling" section that explains this default, which layers
it skips, and its limits. It notes that the default needs no
configuration, and that setting the lazy-pull feature overrides it.

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
@vvoland vvoland self-assigned this Oct 7, 2026
@vvoland
vvoland requested a review from dvdksn as a code owner October 7, 2026 16:46
@netlify

netlify Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit e175735
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6ac6777c4bc23d0008f9c8ee
😎 Deploy Preview https://deploy-preview-26307--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/engine Issue affects Docker engine/daemon area/storage Relates to storage, volumes area/tests labels Oct 7, 2026
@vvoland
vvoland requested a review from docker-agent October 7, 2026 16:51
@vvoland vvoland mentioned this pull request Oct 7, 2026
3 tasks

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/engine Issue affects Docker engine/daemon area/storage Relates to storage, volumes area/tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant