LocalCloud LocalCloud Google Cloud in-a-box
Home Services GitHub Docs

Google Cloud In-a-Box.

Run 20+ GCP services locally in one Docker container. Same SDKs, same APIs, zero code changes, zero cloud costs.

Open the Quick Start Read the Docs
  • 1
    Docker container
    No cloud account or access required for the team
  • $0
    cloud spend during dev / iteration
    stay local until the team is ready
A laptop showing LocalCloud services running inside the screen, with real Google Cloud service icons, readiness panels, and badges for no code changes and zero cloud cost.
Quick Start
Free for Developers !

Up and running in a minute.

  1. 01 Pull and run the Docker image.
  2. 02 Open the console at localhost:8080 to check service health.
  3. 03 Export environment variables and point your SDK to localhost.
docker pull jaysen2apache/localcloud

mkdir -p ~/.localcloud/data

docker run -d \
  -p 8080:8080 -p 4443:4443 \
  -m 4g --name localcloud \
  -v ~/.localcloud/data:/var/lib/localcloud \
  jaysen2apache/localcloud

# Sets env vars
eval "$(curl -s localhost:8080/_localcloud/env?format=shell)"

# Use local Google Object Storage from Local FileSystem
gcloud storage ls gs://
Zero Code Changes
Use the same Google Cloud SDKs and CLIs. Redirect to localhost with environment variables.
Faster Inner Loop
Stay local while you build and test. Switch to shared cloud environments when ready.
Fully Inspectable
Built-in console, health endpoints, env export, and seeded sample data make the runtime transparent.

Service Catalog:

Databases

Transactional, document, wide-column, and cache-style data services for app backends.

Firestore

Document database for app state, user data, and event-driven backends.

Default-on gRPC :8086
Spanner

Relational database surface for strongly consistent SQL and transactional workloads.

Default-on gRPC + REST :9010 / 9020
Bigtable

Wide-column store for large key ranges, event streams, and time-series workloads.

Default-on gRPC :8087
Memorystore

Redis-compatible cache and low-latency data surface for local development.

Default-on RESP2 :6379
Cloud SQL

Managed relational database service for local Cloud SQL API workflow testing.

Opt-in REST :8080
Compute & Runtime

Container, cluster, and instance-style runtime surfaces when app flows need them.

GKE

Cluster-oriented runtime surface for Kubernetes-style local testing.

Opt-in gRPC :8080
Compute Engine

VM-like runtime surface for instance-based local workflows.

Opt-in REST :8080
Cloud Run

Serverless container runtime behavior for local service deployment flows.

Opt-in gRPC :8080
Vertex AI

AI/ML platform service for local model training, prediction, and Vertex AI workflow testing.

Opt-in REST :8080
From the Blog

Guides for Google Cloud local development.

Comparison

LocalCloud vs Google Emulators

Why teams switch from individual emulators to one container — coverage, setup time, and the BigQuery gap.

Continue Exploring

Run every cloud service locally. Build faster, test cheaper.

The homepage tells you what LocalCloud is. The docs and service pages explain how to use it, what each service supports, and where the runtime boundaries are.

Open Documentation Open Service Catalog