Skip to content

Commit a280d06

Browse files
doi: add note about dct retirement (#23246)
<!--Delete sections as needed --> ## Description Added note in the 2 DOI topics noting that: - For consumers, DOI DCT signing certificates will begin to expire - For builders, transition to a new signing solution https://deploy-preview-23246--docsdocker.netlify.app/docker-hub/image-library/trusted-content/ https://deploy-preview-23246--docsdocker.netlify.app/docker-hub/repos/manage/trusted-content/official-images/ ## Related issues or tickets DHI-621 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Editorial review - [ ] Product review Signed-off-by: Craig <[email protected]>
1 parent 1c0beee commit a280d06

File tree

2 files changed

+28
-0
lines changed

2 files changed

+28
-0
lines changed

content/manuals/docker-hub/image-library/trusted-content.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,22 @@ Source Software images.
1818

1919
## Docker Official Images
2020

21+
> [!NOTE]
22+
>
23+
> Docker is retiring Docker Content Trust (DCT) for Docker Official Images
24+
> (DOI). Starting on August 8th, 2025, the oldest of DOI DCT signing
25+
> certificates will begin to expire. You may have already started seeing expiry
26+
> warnings if you use the `docker trust` commands with DOI. These certificates,
27+
> once cached by the Docker client, are not subsequently refreshed, making
28+
> certificate rotation impractical. If you have set the `DOCKER_CONTENT_TRUST`
29+
> environment variable to true (`DOCKER_CONTENT_TRUST=1`), DOI pulls will start to
30+
> fail. The workaround is to unset the `DOCKER_CONTENT_TRUST` environment
31+
> variable. The use of `docker trust inspect` will also start to fail and should
32+
> no longer be used for DOI.
33+
>
34+
> For more details, see
35+
> https://www.docker.com/blog/retiring-docker-content-trust/.
36+
2137
The Docker Official Images are a curated set of Docker repositories hosted on
2238
Docker Hub.
2339

content/manuals/docker-hub/repos/manage/trusted-content/official-images.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,18 @@ aliases:
1010
- /docker-hub/official_images/
1111
---
1212

13+
> [!NOTE]
14+
>
15+
> Docker is retiring Docker Content Trust (DCT) for Docker Official Images
16+
> (DOI). You should start planning to transition to a different image signing
17+
> and verification solution (like [Sigstore](https://www.sigstore.dev/) or
18+
> [Notation](https://github.com/notaryproject/notation#readme)). Docker will
19+
> publish migration guides soon to help you in that effort. Timelines for the
20+
> complete deprecation of DCT are being finalized and will be published soon.
21+
>
22+
> For more details, see
23+
> https://www.docker.com/blog/retiring-docker-content-trust/.
24+
1325
Docker, Inc. sponsors a dedicated team that's responsible for reviewing and
1426
publishing all content in Docker Official Images. This team works in
1527
collaboration with upstream software maintainers, security experts, and the

0 commit comments

Comments
 (0)