Skip to content

Commit 8a805f4

Browse files
hub: add archive repo (#21553)
<!--Delete sections as needed --> ## Description - Added topic for archive or activate a repository - Updated repo landing page topic to add new archive topic - Added note to repo information topic Modified pages: - https://deploy-preview-21553--docsdocker.netlify.app/docker-hub/repos/ - https://deploy-preview-21553--docsdocker.netlify.app/docker-hub/repos/archive/ - https://deploy-preview-21553--docsdocker.netlify.app/docker-hub/repos/manage/information/ ## Related issues or tickets ENGDOCS-2337 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig <[email protected]> Co-authored-by: David Karlsson <[email protected]>
1 parent f9b0855 commit 8a805f4

File tree

5 files changed

+70
-1
lines changed

5 files changed

+70
-1
lines changed

_vale/config/vocabularies/Docker/accept.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -132,6 +132,7 @@ Zsh
132132
[Ss]yscalls?
133133
[Ss]ysfs
134134
[Tt]oolchains?
135+
[Uu]narchived?
135136
[Vv]irtiofs
136137
[Vv]irtualize
137138
[Ww]alkthrough

content/manuals/docker-hub/repos/_index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,8 @@ In this section, learn how to:
4646
- [Automated builds](./manage/builds/_index.md): Integrate with GitHub or
4747
Bitbucket for automated builds. Every code change triggers an image
4848
rebuild, supporting continuous integration and delivery.
49-
49+
50+
- [Archive](./archive.md) an outdated or unsupported repository.
5051
- [Delete](./delete.md) a repository.
5152
- [Manage personal settings](./settings.md): For your account, you can set personal
5253
settings for repositories, including default repository privacy and autobuild
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
description: Learn how to archive or unarchive a repository on Docker Hub
3+
keywords: Docker Hub, Hub, repositories, archive, unarchive
4+
title: Archive or unarchive a repository
5+
linkTitle: Archive
6+
toc_max: 3
7+
weight: 35
8+
---
9+
10+
You can archive a repository on Docker Hub to mark it as read-only and indicate
11+
that it's no longer actively maintained. This helps prevent the use of outdated
12+
or unsupported images in workflows. Archived repositories can also be unarchived
13+
if needed.
14+
15+
Docker Hub highlights repositories that haven't been updated in over a year by
16+
displaying an icon ({{< inline-image src="./images/outdated-icon.webp"
17+
alt="outdated icon" >}}) next to them on the [**Repositories**
18+
page](https://hub.docker.com/repositories/). Consider reviewing these
19+
highlighted repositories and archiving them if necessary.
20+
21+
When a repository is archived, the following occurs:
22+
23+
- The repository information can't be modified.
24+
- New images can't be pushed to the repository.
25+
- An **Archived** label is displayed on the public repository page.
26+
- Users can still pull the images.
27+
28+
You can unarchive an archived repository to remove the archived state. When
29+
unarchived, the following occurs:
30+
31+
- The repository information can be modified.
32+
- New images can be pushed to the repository.
33+
- The **Archived** label is removed on the public repository page.
34+
35+
## Archive a repository
36+
37+
1. Sign in to [Docker Hub](https://hub.docker.com).
38+
2. Select **Repositories**.
39+
40+
A list of your repositories appears.
41+
42+
3. Select a repository.
43+
44+
The **General** page for the repository appears.
45+
46+
4. Select the **Settings** tab.
47+
5. Select **Archive repository**.
48+
6. Enter the name of your repository to confirm.
49+
7. Select **Archive**.
50+
51+
## Unarchive a repository
52+
53+
1. Sign in to [Docker Hub](https://hub.docker.com).
54+
2. Select **Repositories**.
55+
56+
A list of your repositories appears.
57+
58+
3. Select a repository.
59+
60+
The **General** page for the repository appears.
61+
62+
4. Select the **Settings** tab.
63+
5. Select **Unarchive repository**.
198 Bytes
Loading

content/manuals/docker-hub/repos/manage/information.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,10 @@ Each repository can include a description, an overview, and categories to help
1212
users understand its purpose and usage. Adding clear repository information
1313
ensures that others can find your images and use them effectively.
1414

15+
You can only modify the repository information of repositories that aren't
16+
archived. If a repository is archived, you must unarchive it to modify the
17+
information. For more details, see [Unarchive a repository](../archive.md#unarchive-a-repository).
18+
1519
## Repository description
1620

1721
The description appears in search results when using the `docker search` command

0 commit comments

Comments
 (0)