Skip to content

docs: clarify dhi.io proxy access in the mirroring guide - #26232

Merged
craig-osterhout merged 2 commits into
docker:mainfrom
brianru:docs/clarify-dhi-mirroring-proxy
Sep 30, 2026
Merged

craig-osterhout merged 2 commits into
docker:mainfrom
brianru:docs/clarify-dhi-mirroring-proxy

Conversation

@brianru

@brianru brianru commented Sep 30, 2026 •

Copy link
Copy Markdown

Description

The third-party mirroring guide describes image layers as stored on dhi.io, which makes it unclear why the examples use Docker Hub for images and the Scout registry for attestations.

Clarify that dhi.io provides access to DHI catalog images and their signed attestations, while customer mirrors and customized images in organization repositories are accessed through Docker Hub. This explains why the examples copy images from Docker Hub and attestations from registry.scout.docker.com into the same destination repository. Copying only the image does not preserve its attestations.

The proxy's repository routing rejects names containing / and maps accepted names into the dhi/ namespace: routing implementation. The public image reference documentation also distinguishes catalog references on dhi.io from organization repositories on Docker Hub.

Reviews

  • Technical review
  • Editorial review
  • Product review

Validation

  • npx --no-install rumdl fmt content/manuals/dhi/how-to/mirror.md
  • scripts/lint.sh content/manuals/dhi/how-to/mirror.md with repository-pinned rumdl 0.2.49 and Vale 3.17.0: no errors, warnings, or suggestions
  • git diff --check

This is a prose-only change. The mirroring commands are unchanged. A full site build was not run.

Signed-off-by: Brian Rubinton <brian.rubinton@docker.com>
@netlify

netlify Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 6c635e2
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6abd6de2678eae00082290e3
😎 Deploy Preview https://deploy-preview-26232--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.

Signed-off-by: Brian Rubinton <brian.rubinton@docker.com>
@brianru
brianru marked this pull request as ready for review September 30, 2026 20:24

@craig-osterhout craig-osterhout left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you. LGTM

@craig-osterhout
craig-osterhout merged commit 5c66691 into docker:main Sep 30, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants