floci-gcp
Light, fluffy, and always free — GCP Local Emulator
floci-gcp is a fast, free, and open-source local GCP emulator built for developers who need reliable GCP services in development and CI without cost, complexity, or account setup.
Supported Services
| Service | Protocol | Notable features |
|---|---|---|
| Cloud Storage (GCS) | REST XML + REST JSON | Buckets, objects, multipart upload, object compose, ACLs, bucket IAM, conditional requests, versioning, pre-signed URLs |
| Pub/Sub | gRPC | Topics, subscriptions, publish, pull, streaming pull, push delivery, snapshots, seek |
| Firestore | gRPC | Documents, collections, queries, field transforms, aggregation, transactions, real-time listeners |
| Datastore | HTTP/protobuf | Entities, structured queries, GQL queries, aggregation, transactions |
| Secret Manager | gRPC | Secrets, versions, access, disable/enable/destroy, IAM bindings |
| IAM | REST | Service accounts, RSA-2048 keys, policy bindings, SignBlob (V4 signed URLs) |
| Managed Kafka | REST | Clusters, topics, consumer groups (Redpanda-backed or mock mode) |
Why floci-gcp?
No account required. No auth tokens, no sign-ups, no telemetry. Pull the image and start building.
Single port. All GCP services — gRPC and REST — on port 4588 via ALPN negotiation. No per-service setup.
No feature gates. Every feature is available to everyone — no community-edition restrictions.
No CI restrictions. Run in your CI pipeline with zero limitations. No credits, no quotas, no paid tiers.
Truly open source. MIT licensed. Fork it, extend it, embed it.
Quick Start
services:
floci-gcp:
image: floci/floci-gcp:latest
ports:
- "4588:4588"
volumes:
- ./data:/app/data
environment:
FLOCI_GCP_HOSTNAME: floci-gcp
FLOCI_GCP_BASE_URL: http://floci-gcp:4588
Point your GCP SDKs at the emulator:
export PUBSUB_EMULATOR_HOST=localhost:4588
export FIRESTORE_EMULATOR_HOST=localhost:4588
export DATASTORE_EMULATOR_HOST=localhost:4588
export STORAGE_EMULATOR_HOST=http://localhost:4588
export SECRET_MANAGER_EMULATOR_HOST=localhost:4588
export GOOGLE_CLOUD_PROJECT=floci-local
All GCP services are immediately available at http://localhost:4588. Credentials are not validated.