mirror of https://github.com/docker/docs.git
				
				
				
			hub: add image management (#22052)
<!--Delete sections as needed --> ## Description Added topic for new image management feature. Updated usage management topic to reference new topic. Updated release notes. - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/repos/manage/hub-images/ - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/repos/manage/hub-images/manage/ - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/usage/manage/ - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/release-notes/ ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig <craig.osterhout@docker.com> Co-authored-by: Sarah Sanders <sarah.sanders@docker.com>
This commit is contained in:
		
							parent
							
								
									f488c8a10d
								
							
						
					
					
						commit
						9bfe7ad474
					
				| 
						 | 
				
			
			@ -15,6 +15,12 @@ known issues for each Docker Hub release.
 | 
			
		|||
 | 
			
		||||
Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projects/51/views/1?filterQuery=) to see what's coming next.
 | 
			
		||||
 | 
			
		||||
## 2025-02-18
 | 
			
		||||
 | 
			
		||||
### New
 | 
			
		||||
 | 
			
		||||
- You can delete images and image indexes using [Image Management](./repos/manage/hub-images/manage.md).
 | 
			
		||||
 | 
			
		||||
## 2024-12-12
 | 
			
		||||
 | 
			
		||||
### New
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -12,9 +12,12 @@ version-controlled, and easy to share. This section covers key image management
 | 
			
		|||
tasks, including tagging, pushing images, transferring images between
 | 
			
		||||
repositories, and supported software artifacts.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
- [Tags](./tags.md): Tags help you version and organize different iterations of
 | 
			
		||||
  your images within a single repository. This topic explains tagging and
 | 
			
		||||
  provides guidance on how to create, view, and delete tags in Docker Hub.
 | 
			
		||||
- [Image Management](./manage.md): Manage your images and image indexes to
 | 
			
		||||
  optimize your repository storage.
 | 
			
		||||
- [Software artifacts](./oci-artifacts.md): Docker Hub supports OCI (Open
 | 
			
		||||
  Container Initiative) artifacts, allowing you to store, manage, and distribute
 | 
			
		||||
  a range of content beyond standard Docker images, including Helm charts,
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
										
											
												File diff suppressed because one or more lines are too long
											
										
									
								
							| 
		 After Width: | Height: | Size: 21 KiB  | 
| 
						 | 
				
			
			@ -0,0 +1,52 @@
 | 
			
		|||
---
 | 
			
		||||
description: Discover how to delete image tags.
 | 
			
		||||
keywords: Docker Hub, Hub, tags, delete
 | 
			
		||||
title: Image Management
 | 
			
		||||
linktitle: Image Management
 | 
			
		||||
weight: 12
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
{{< summary-bar feature_name="Image management" >}}
 | 
			
		||||
 | 
			
		||||
Images and image indexes are the foundation of container images within a
 | 
			
		||||
repository. The following diagram shows the relationship between images and
 | 
			
		||||
image indexes.
 | 
			
		||||
 | 
			
		||||
  
 | 
			
		||||
 | 
			
		||||
This structure enables multi-architecture support through a single reference. It
 | 
			
		||||
is important to note that images are not always referenced by an image index.
 | 
			
		||||
The following objects are shown in the diagram.
 | 
			
		||||
 | 
			
		||||
- Image index: An image that points to multiple architecture-specific images
 | 
			
		||||
  (like AMD and ARM), letting a single reference work across different
 | 
			
		||||
  platforms.
 | 
			
		||||
- Image: Individual container images that contain the actual configuration and
 | 
			
		||||
  layers for a specific architecture and operating system.
 | 
			
		||||
 | 
			
		||||
## Manage repository images and image indexes
 | 
			
		||||
 | 
			
		||||
1. Sign in to [Docker Hub](https://hub.docker.com).
 | 
			
		||||
2. Select **Repositories**.
 | 
			
		||||
3. In the list, select a repository.
 | 
			
		||||
4. Select **Image Management**.
 | 
			
		||||
5. Search, filter, or sort the items.
 | 
			
		||||
   - Search: In the search box above the list, specify your search.
 | 
			
		||||
   - Filter: In the **Filter by** drop-down, select **Tagged**, **Image index**,
 | 
			
		||||
     or **Image**.
 | 
			
		||||
   - Sort: Select the column title for **Size**, **Last pushed**, or **Last
 | 
			
		||||
     pulled**.
 | 
			
		||||
 | 
			
		||||
   > [!NOTE]
 | 
			
		||||
   >
 | 
			
		||||
   > Images that haven't been pulled in over 6 months are marked as **Stale** in
 | 
			
		||||
   > the **Status** column.
 | 
			
		||||
 | 
			
		||||
6. Optional. Delete one or more items.
 | 
			
		||||
   1. Select the checkboxes next to the items in the list. Selecting any
 | 
			
		||||
      top-level index also removes any underlying images that aren't referenced
 | 
			
		||||
      elsewhere.
 | 
			
		||||
   2. Select **Preview and delete**.
 | 
			
		||||
   3. In the window that appears, verify the items that will be deleted and the
 | 
			
		||||
      amount of storage you will reclaim.
 | 
			
		||||
   4. Select **Delete forever**.
 | 
			
		||||
| 
						 | 
				
			
			@ -33,8 +33,8 @@ both individuals and organizations:
 | 
			
		|||
 | 
			
		||||
4. Optimize your storage by:
 | 
			
		||||
 | 
			
		||||
    - Regularly auditing and removing repositories with untagged, unused, or outdated images.
 | 
			
		||||
    - Looking for private repositories in Hub storage that exceed your plan's limits.
 | 
			
		||||
    - Regularly auditing and [removing entire repositories](../repos/delete.md) with untagged, unused, or outdated images.
 | 
			
		||||
    - Using [Image Management](../repos/manage/hub-images/manage.md) to remove stale and outdated images within a repository.
 | 
			
		||||
 | 
			
		||||
5. Increase your limits by upgrading or purchasing additional consumption. For
 | 
			
		||||
   details, see [Scale your subscription](/manuals/subscription/scale.md).
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -150,6 +150,8 @@ GitHub Actions cache:
 | 
			
		|||
Hardened Docker Desktop:
 | 
			
		||||
  subscription: [Business]
 | 
			
		||||
  for: Administrators
 | 
			
		||||
Image management:
 | 
			
		||||
  availability: Beta
 | 
			
		||||
Import builds:
 | 
			
		||||
  availability: Beta
 | 
			
		||||
  requires: Docker Desktop [4.31](/manuals/desktop/release-notes.md#4310) and later
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
		Reference in New Issue