🔵 Google Cloud Storage

Native Google Cloud Storage integration with automatic credential detection on GCE, GKE, Cloud Run, and Cloud Functions. Multi-region buckets for automatic geographic redundancy.

Configuration

gcs-images:
  type: gcs
  bucket: my-bucket
  prefix: images/
  projectId: my-project       # auto-detected on GCP
  keyFilename: /path/to/key.json  # for non-GCP environments

Authentication

MethodBest For
Application Default CredentialsGCE, GKE, Cloud Run — zero config
Service account key fileNon-GCP environments (AWS, local)
Environment variableGOOGLE_APPLICATION_CREDENTIALS

Permissions

Assign Storage Object Viewer role (roles/storage.objectViewer) to the service account.

Multi-Region Buckets

GCS multi-region buckets (US, EU, ASIA) provide automatic geographic redundancy. Deploy Image Foundry in the same multi-region for lowest latency.

Connect Your Storage in Minutes

Free tier — no credit card required.

Get Started Free Read the Docs