How to Delete an Image from Docker Hub

Deleting an image from Docker Hub can be done using the Docker Hub API or through the Docker Hub web interface. This guide will provide step-by-step instructions for both methods, along with sample code for using the API.

Method 1: Deleting an Image Using the Docker Hub API

To delete an image using the Docker Hub API, you need to authenticate and then send a DELETE request to the appropriate endpoint. Below are the steps:

Step 1: Authenticate

First, you need to authenticate with Docker Hub to obtain a JWT token. Use the following command:

curl -s -H "Content-Type: application/json" -X POST -d '{"username":"your_username", "password":"your_password"}' "https://hub.docker.com/v2/users/login/"

This command will return a token that you will use in subsequent requests.

Step 2: Get the Tags of the Image

Next, retrieve the tags associated with the image you want to delete:

curl "https://hub.docker.com/v2/repositories/your_username/your_repository/tags" -X GET -H "Authorization: JWT ${TOKEN}"

Replace your_username and your_repository with your actual Docker Hub username and repository name.

Step 3: Delete the Image Tag

Once you have the tag name, you can delete it using the following command:

curl "https://hub.docker.com/v2/repositories/your_username/your_repository/tags/your_tag/" -X DELETE -H "Authorization: JWT ${TOKEN}"

Replace your_tag with the actual tag you want to delete.

Method 2: Deleting an Image Using the Docker Hub Web Interface

If you prefer a graphical interface, you can delete images directly from the Docker Hub website:

Step 1: Sign In to Docker Hub

Go to Docker Hub and sign in with your credentials.

Step 2: Navigate to Your Repository

Once logged in, navigate to the repository that contains the image you want to delete.

Step 3: Manage Repository

Click on the Manage repository button to access the settings for your repository.

Step 4: Delete the Image

In the settings, scroll down to the Delete Repository section. Click the delete button and confirm your action to remove the image.

Conclusion

Deleting an image from Docker Hub can be accomplished through the API or the web interface. Using the API allows for automation and scripting, while the web interface provides a user-friendly way to manage your images. Choose the method that best fits your workflow.