Deleting a Docker image from a registry

Written by

Updated at November 24, 2025

Alert

Deleting a Docker image is a deferred action operation: once you delete a Docker image, its layers get physically removed after some time, which depends on total volume of data. The registry total size info will be updated 1 hour after physical removal.

To delete a Docker image from the registry, you need the container-registry.images.pusher role or higher.

Management console

CLI

API

To delete a Docker image:

Go to the repository to remove the image from:
1. Navigate to the folder dashboard and select Container Registry.
2. Open the appropriate registry.
3. Open the repository.
Click next to the Docker image you want to delete.
In the menu that opens, click Delete.
In the window that opens, click Delete.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

To delete a Docker image, use the image ID. You can retrieve the ID by requesting a list of Docker images in the desired registry.

Delete the Docker image:

yc container image delete crp9vik7sgec********

Make sure the Docker image has been deleted:

yc container image list

Result:

+----+---------+------+------+-----------------+
| ID | CREATED | NAME | TAGS | COMPRESSED SIZE |
+----+---------+------+------+-----------------+
+----+---------+------+------+-----------------+

To delete a Docker image, use the delete method for the Image resource.

Deleting a Docker image from a registry

Was the article helpful?