Compute Engine: The resource 'projects/X/global/images/family/Y' was not found (image or family missing)

The VM/template references an image or family that doesn't exist, was deprecated or is in another project.

Exact message you may see The resource 'projects/debian-cloud/global/images/family/debian-9' was not foundimage family not found Compute EngineThe resource was not found images familyInvalid value for field 'resource.disks[0].initializeParams.sourceImage'was not found
Seen on: Google Cloud

Meaning

Check the image project (--image-project=debian-cloud), the family spelling, and deprecated/obsolete images (gcloud compute images list --filter="family~debian"). Use a current family and make sure custom images are shared with the project.

Common causes

  • Typo in image/family name
  • Wrong --image-project
  • Image deprecated or deleted
  • Custom image not shared
  • Region-specific image not available

⚡ Quick fix

  1. gcloud compute images list --filter="family~debian"
  2. Add the right --image-project
  3. Use a supported current family

Detailed fix by platform

Shell

  1. gcloud compute instances create vm --image-family=debian-12 --image-project=debian-cloud --zone=ZONE

How to diagnose

  1. Family — Exists?
  2. Project — Correct?
  3. Image — Deprecated?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Platform & cloud. Errors that are often confused with or caused by this one (click to open):

409: The resource already exists — Compute Engine: ERROR: (gcloud.compute.instances.create) Could not fetch resource: The resource 'projects/p/zones/z/instances/vm-1' already exists (Google Cloud / Firebase)409: The resource alr…autohealing — Managed instance group keeps recreating VMs: autohealing health check failing (Google Cloud / Firebase)autohealingCloud Run: Image not found / failed to pull — Cloud Run: Revision 'svc-00005' is not ready — Image 'gcr.io/proj/app:latest' not found / Permission 'artifactregistry.repositories.downloadArtifacts' denied (Google Cloud / Firebase)Cloud Run: Image not …Compute Engine: Quota exceeded (regional limit) — Compute Engine: Quota 'N2_CPUS' exceeded. Limit: 24.0 in region europe-west1 / QUOTA_EXCEEDED (Google Cloud / Firebase)Compute Engine: Quota…disk full — Compute Engine VM disk full: No space left on device — resize the persistent disk and filesystem (Google Cloud / Firebase)disk fullIAP tunnel: Error 4033 not authorized — gcloud compute ssh: ERROR: (gcloud.compute.start-iap-tunnel) Error while connecting [4033: 'not authorized'] (Google Cloud / Firebase)IAP tunnel: Error 403…IN_USE_ADDRESSES — Quota 'IN_USE_ADDRESSES' exceeded (external IP addresses) in region (Google Cloud / Firebase)IN_USE_ADDRESSESobject-not-found — Firebase Storage: storage/object-not-found — No object exists at the desired reference (Google Cloud / Firebase)object-not-foundimage fam…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.