Container Registry is deprecated. Effective March 18, 2025,Container Registry is shut down and writing images to Container Registry isunavailable.

Container Registry shutdown

The shutdown is scheduled as follows:

• Effective March 18, 2025, writing images to Container Registry isunavailable.
• After June 03, 2025, reading images from Container Registry isunavailable. Existing images in Container Registry are inaccessible.
• Effective October 14, 2025, if you have completed the steps to set upgcr.io repositories in Artifact Registry, thenpushing togcr.io endpoints stores images in Artifact Registry and allgcr.io URLs are served from Artifact Registry. Any imagesin Container Registry that haven't been copied to Artifact Registry areunavailable.

Transition to Artifact Registry

Depending on how you configure and use Container Registry, you mightneed to perform some configuration steps to prepare a new project to successfullyhandle requests to thegcr.io domain. For example, principals that accessthe repositories must have an appropriate Artifact Registry role or a role withequivalent permissions.

We recommend that you transition projects with active Container Registry usage toArtifact Registry repositories. SeeTransition from Container Registryto learn about feature differences and transition options.

Use our transition tooling

Warning: After June 03, 2025, if you haven't transitioned toArtifact Registry, then images in Container Registry are inaccessible.

Use the following tools to check which projects have Container Registry usage,copy images from Container Registry to Artifact Registry, and automatically migratemultiple projects from Container Registry to Artifact Registry.

• Check Container Registry usage.
• Use ourmigration tool to migrate projects fromContainer Registry to Artifact Registry, copy images, and select your preferredtransition repository type.

We will continue to communicate changes to the service in accordance with theGoogle Cloud terms of service.

Container Registry deprecation history

The following restrictions were implemented as part of our phased approach todiscontinuing Container Registry:

• Effective March 18, 2025, writing images to Container Registry isunavailable.
• Effective January 8, 2024, in organizations that haven't usedContainer Registry before, and in projects that don't belong to organizations,all newgcr.io repositories are hosted on Artifact Registry by default.
• Effective May 15, 2024, Google Cloud projects without previous usage ofContainer Registry only supportgcr.io repositories hosted inArtifact Registry.
• Effective May 15, 2023, Container Registry is deprecated.