Local Google Cloud Dev Env. for BigQuery, Spanner, Pub/Sub, Dataproc, and more with MCP and UI
10K+
Complete local Google Cloud runtime and emulator suite in a single Docker container.
LocalCloud provides a local development and testing environment for Google Cloud Platform (GCP). It enables developers and CI/CD pipelines to build, test, and debug cloud applications entirely offline without incurring cloud costs, configuring IAM service accounts, or managing disparate emulator instances.
http://localhost:5380 for querying tables, inspecting buckets, viewing topics, and managing resources./mcp for direct integration with Cursor, Claude Code, Antigravity, and AI coding assistants.gcloud, gsutil, and Terraform./var/lib/localcloud) and automated data seeding.linux/amd64 and linux/arm64 (Apple Silicon).Start the container and publish the service gateway and emulator ports:
docker run -d --name localcloud \
-p 5380-5405:5380-5405 \
-v localcloud-data:/var/lib/localcloud \
agentcloud/localcloud:latest
Open the web console at http://localhost:5380.
Point standard Google Cloud client SDKs to the local runtime via standard environment variables:
# Cloud Storage
export STORAGE_EMULATOR_HOST="http://localhost:5382"
# Cloud Pub/Sub
export PUBSUB_EMULATOR_HOST="localhost:5383"
# BigQuery
export BIGQUERY_EMULATOR_HOST="http://localhost:5388"
# Cloud Spanner
export SPANNER_EMULATOR_HOST="localhost:5386"
# Cloud Bigtable
export BIGTABLE_EMULATOR_HOST="localhost:5385"
# Firestore
export FIRESTORE_EMULATOR_HOST="localhost:5384"
# Secret Manager
export SECRET_MANAGER_EMULATOR_HOST="localhost:5380"
lc)For automatic port management, workspace detection, and transparent DNS:
# Install via Homebrew
brew install LocalGCloud/tap/localcloud
# Start LocalCloud
lc start
| Tag | Variant | Description |
|---|---|---|
latest | Full (default) | Complete runtime including BigQuery ML, JavaScript UDFs, external queries, and k3d for real GKE clusters. |
lite | Lite | Lightweight footprint (~355 MB) optimized for fast CI/CD and everyday local development without ML models. |
0.1.16 | Versioned | Stable tagged release builds (<version> and <version>-lite). |
| Service | Protocol | Default Port | Client Environment Variable |
|---|---|---|---|
| Cloud Storage | REST / XML | 5382 | STORAGE_EMULATOR_HOST |
| Cloud Pub/Sub | gRPC | 5383 | PUBSUB_EMULATOR_HOST |
| Cloud Spanner | gRPC / REST | 5386 / 5387 | SPANNER_EMULATOR_HOST |
| BigQuery | REST / gRPC | 5388 / 5389 | BIGQUERY_EMULATOR_HOST |
| Cloud SQL (Postgres / MySQL) | Native | 5391 / 5406 | CLOUD_SQL_EMULATOR_HOST |
| Cloud Bigtable | gRPC | 5385 | BIGTABLE_EMULATOR_HOST |
| Firestore | gRPC / REST | 5384 | FIRESTORE_EMULATOR_HOST |
| Memorystore (Redis/Valkey) | Redis | 5390 | REDIS_HOST |
| Secret Manager | gRPC | 5380 | SECRET_MANAGER_EMULATOR_HOST |
| Cloud Tasks | gRPC | 5380 | CLOUD_TASKS_EMULATOR_HOST |
| Cloud Scheduler | gRPC / REST | 5380 | CLOUD_SCHEDULER_EMULATOR_HOST |
| Cloud Functions (2nd Gen) | gRPC | 5380 | CLOUD_FUNCTIONS_EMULATOR_HOST |
| Dataproc (Spark/Hadoop) | gRPC | 5380 | DATAPROC_EMULATOR_HOST |
| Cloud KMS | gRPC / REST | 5380 | CLOUD_KMS_EMULATOR_HOST |
| AlloyDB | gRPC | 5380 | ALLOYDB_EMULATOR_HOST |
| Google Sheets API | REST | 5380 | SHEETS_EMULATOR_HOST |
| Cloud IAM & Resource Mgr | gRPC / REST | 5380 | IAM_EMULATOR_HOST |
| Cloud Logging & Monitoring | gRPC | 5380 | CLOUD_LOGGING_EMULATOR_HOST |
| GKE / Cloud Run / Workflows | REST / gRPC | 5380 | Gateway routes |
LocalCloud exposes a built-in Model Context Protocol (MCP) server on port 5380:
# Connect any MCP-enabled agent directly to:
http://localhost:5380/mcp
Or configure Cursor / Claude Code / Antigravity with headers:
{
"mcpServers": {
"localcloud": {
"url": "http://127.0.0.1:5380/mcp",
"headers": {
"X-LocalCloud-Project": "my-project",
"X-LocalCloud-User": "developer"
}
}
}
}
Mount a persistent volume to preserve state across restarts:
-v localcloud-data:/var/lib/localcloud
To pre-load schemas, buckets, tables, or seed data at container startup, pass a seed file:
-e LOCALCLOUD_SEED_FILE=/seed.yaml -v ./seed.yaml:/seed.yaml:ro
Or trigger dynamic reseeding via the operator API:
curl -X POST http://localhost:5380/seed -H "Content-Type: application/yaml" --data-binary @seed.yaml
Content type
Image
Digest
sha256:33622d532…
Size
483.6 MB
Last updated
6 days ago
docker pull agentcloud/localcloud