Container Registry is deprecated and scheduled for shutdown. Effective May 15, 2024, Artifact Registry hosts images for the gcr.io domain in projects without previous Container Registry usage. After March 18, 2025, Container Registry will be shut down.

To get started with managing containers on Google Cloud, use Artifact Registry. If you use Container Registry, learn how to transition to Artifact Registry to manage your containers on Google Cloud.

For more information on the deprecation and shutdown, see the deprecations page and release notes.

Disable the service

This page describes the steps to disable Container Registry.

Disabling the service

Disabling the Container Registry API does not delete container images stored in Cloud Storage buckets for registry hosts. You will continue to incur Cloud Storage storage and network egress charges for stored images.

If you are no longer using Container Registry and do not need the retain the images, delete the storage buckets.

Disable the API

To disable the API from the Google Cloud console:

console

Go to the API Overview page for Container Registry.
Select the project where the API is enabled.
Click Manage.
Click Disable API.

gcloud

Run the following command to disable the API for your current project:

gcloud services disable containerregistry.googleapis.com

Delete storage buckets

Delete the storage buckets for Container Registry if you are no longer using Container Registry

To delete each Container Registry storage bucket:

Console

Go to the Cloud Storage page in the Google Cloud console.
Select the storage bucket to delete. In the bucket names, PROJECT-ID is your Google Cloud project ID.
- gcr.io: artifacts.PROJECT-ID.appspot.com
- asia.gcr.io: asia.artifacts.PROJECT-ID.appspot.com
- eu.gcr.io: eu.artifacts.PROJECT-ID.appspot.com
- us.gcr.io: us.artifacts.PROJECT-ID.appspot.com
Click Delete. A confirmation dialog box appears.
To confirm deletion, enter the bucket name and then click Delete.

gcloud

If you want to bulk delete a hundred thousand or more images in a bucket, avoid using the gcloud CLI since the deletion process takes a long time to complete. Use the Google Cloud console to perform the operation instead. For more information, see deleting Cloud Storage objects in bulk.

To delete a bucket, use the gcloud storage rm command with the --recursive flag.

gcloud storage rm gs://BUCKET-NAME --recursive

Replace BUCKET-NAME with the Container Registry storage bucket name. In the bucket names, PROJECT-ID is your Google Cloud project ID.

gcr.io: artifacts.PROJECT-ID.appspot.com
asia.gcr.io: asia.artifacts.PROJECT-ID.appspot.com
eu.gcr.io: eu.artifacts.PROJECT-ID.appspot.com
us.gcr.io: us.artifacts.PROJECT-ID.appspot.com

The response looks like the following example:

Removing gs://artifacts.my-project.appspot.com/...

If other Google Cloud services are running in the same Google Cloud project, leave the Container Registry API enabled. If you try to disable the Container Registry API. Container Registry displays a warning if other services with a configured dependency are enabled in the project. Disabling the Container Registry API automatically disables any services in the same project with a configured dependency, even if you are not currently using Container Registry with those services.

What's next

Configure access permissions