---
name: Registry-ts_image_restore
title: Why do I get an error when I'm restoring an image in Container Registry?
description: 'You want to restore an image from the IBM Cloud® Container Registry trash, but you get a 409 error: `CRT0500E The tagged image already exists. You can restore this image by using the digest.`'
last-updated: 2025-10-14
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/Registry?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Why do I get an error when I'm restoring an image in Container Registry?
{: #troubleshoot-image-restore}
{: troubleshoot}
{: support}

You want to restore an image from the IBM Cloud® Container Registry trash, but you get a 409 error: `CRT0500E The tagged image already exists. You can restore this image by using the digest.`
{: shortdesc}

You get the following error message when you run the [`ibmcloud cr image-restore`](https://cloud.ibm.com/docs/Registry?topic=Registry-containerregcli&format=markdown#bx_cr_image_restore) command: `CRT0500E The tagged image already exists. You can restore this image by using the digest. For more information, see troubleshooting: https://cloud.ibm.com/docs/Registry?topic=Registry-ts_index#ts_image_restore`
{: tsSymptoms}

An image with the same name exists in your live repository. You can't overwrite a live image with an image that is in the trash.
{: tsCauses}

Remove the [tag](#x2040924){: term} from the existing image in your live repository by running the [`ibmcloud cr image-untag`](https://cloud.ibm.com/docs/Registry?topic=Registry-containerregcli&format=markdown#bx_cr_image_untag) command. You can then restore the required image from the trash by running the [`ibmcloud cr image-restore`](https://cloud.ibm.com/docs/Registry?topic=Registry-containerregcli&format=markdown#bx_cr_image_restore) command with the option `<repo>@<digest>`, which restores the digest and its tags to the live repository. For more information, see [Restoring images by digest](https://cloud.ibm.com/docs/Registry?topic=Registry-registry_images_&format=markdown#registry_images_restore_digest).
{: tsResolve}