Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions _vale/config/vocabularies/Docker/accept.txt
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,7 @@ Zsh
[Ss]warm
[Ss]ysfs
[Tt]oolchains?
[Uu]narchived?
[Vv]irtiofs
[Vv]irtualize
[Ww]alkthrough
Expand Down
3 changes: 2 additions & 1 deletion content/manuals/docker-hub/repos/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,8 @@ In this section, learn how to:
- [Automated builds](./manage/builds/_index.md): Integrate with GitHub or
Bitbucket for automated builds. Every code change triggers an image
rebuild, supporting continuous integration and delivery.


- [Archive](./archive.md) an outdated or unsupported repository.
- [Delete](./delete.md) a repository.
- [Manage personal settings](./settings.md): For your account, you can set personal
settings for repositories, including default repository privacy and autobuild
Expand Down
63 changes: 63 additions & 0 deletions content/manuals/docker-hub/repos/archive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
description: Learn how to archive or unarchive a repository on Docker Hub
keywords: Docker Hub, Hub, repositories, archive, unarchive
title: Archive or unarchive a repository
linkTitle: Archive
toc_max: 3
weight: 35
---

You can archive a repository on Docker Hub to mark it as read-only and indicate
that it's no longer actively maintained. This helps prevent the use of outdated
or unsupported images in workflows. Archived repositories can also be unarchived
if needed.

Docker Hub highlights repositories that haven't been updated in over a year by
displaying an icon ({{< inline-image src="./images/outdated-icon.webp"
alt="outdated icon" >}}) next to them on the [**Repositories**
page](https://hub.docker.com/repositories/). Consider reviewing these
highlighted repositories and archiving them if necessary.

When a repository is archived, the following occurs:

- The repository information can't be modified.
- New images can't be pushed to the repository.
- An **Archived** label is displayed on the public repository page.
- Users can still pull the images.

You can unarchive an archived repository to remove the archived state. When
unarchived, the following occurs:

- The repository information can be modified.
- New images can be pushed to the repository.
- The **Archived** label is removed on the public repository page.

## Archive a repository

1. Sign in to [Docker Hub](https://hub.docker.com).
2. Select **Repositories**.

A list of your repositories appears.

3. Select a repository.

The **General** page for the repository appears.

4. Select the **Settings** tab.
5. Select **Archive repository**.
6. Enter the name of your repository to confirm.
7. Select **Archive**.

## Unarchive a repository

1. Sign in to [Docker Hub](https://hub.docker.com).
2. Select **Repositories**.

A list of your repositories appears.

3. Select a repository.

The **General** page for the repository appears.

4. Select the **Settings** tab.
5. Select **Unarchive repository**.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions content/manuals/docker-hub/repos/manage/information.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ Each repository can include a description, an overview, and categories to help
users understand its purpose and usage. Adding clear repository information
ensures that others can find your images and use them effectively.

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

## Repository description

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