Floci is a family of fast, free, open-source local cloud emulators built with Quarkus Native. One container per cloud, one port each, no auth tokens, no feature gates, no telemetry. Ever.
Named after cirrocumulus floccus, the cloud formation that looks like popcorn. 🍿
docker run --rm -p 4566:4566 floci/floci:latest # AWS
docker run --rm -p 4577:4577 floci/floci-az:latest # Azure
docker run --rm -p 4588:4588 floci/floci-gcp:latest # Google CloudThat's it. No sign-ups. No API keys.
LocalStack's community edition sunset in March 2026, now requiring auth tokens and frozen security updates. Microsoft's Azure emulators are fragmented across Azurite, Cosmos DB Emulator (Windows-only), and Functions Core Tools. Google ships per-service gcloud beta emulators that each run on a different port with different config.
Floci fills all of that with one consistent emulator family, and stays MIT-licensed forever.
| Floci | LocalStack Community | Azurite + friends | gcloud emulators |
|
|---|---|---|---|---|
| Auth token | None | Required (since March 2026) | N/A | N/A |
| Unified endpoint | One port per cloud | One port | Per-service | Per-service |
| Startup time (AWS) | ~24 ms | ~3.3 s | n/a | n/a |
| Idle memory (AWS) | ~13 MiB | ~143 MiB | n/a | n/a |
| Docker image size | ~90 MB | ~1.0 GB | varies | varies |
| License | MIT | Restricted | varies | varies |
| Real Docker engines | ✅ Lambda, RDS, EKS, MSK, … | ❌ | partial | partial |
github.com/floci-io/floci · port 4566 · image floci/floci
41 services including EC2, ECS, EKS, Lambda, RDS, ElastiCache, MSK, OpenSearch, ECR, CodeBuild, S3, DynamoDB, SQS, SNS, IAM, STS, KMS, Cognito, EventBridge, Step Functions, CloudFormation, API Gateway, and more. 100% SDK compatibility (1,925 / 1,925 tests).
github.com/floci-io/floci-az · port 4577 · image floci/floci-az
Blob, Queue, Table, Cosmos DB, Functions, App Configuration, Key Vault, and Event Hubs on a single endpoint. Drop-in alternative to running Azurite, Cosmos DB Emulator, and Functions Core Tools side by side.
github.com/floci-io/floci-gcp · port 4588 · image floci/floci-gcp
Cloud Storage, Pub/Sub, Firestore, Datastore, Bigtable, Spanner, and Cloud Functions on a single endpoint. One container instead of seven separate gcloud beta emulators processes.
- floci-duck: a DuckDB-backed query sidecar that powers Athena and Firehose.
- testcontainers-floci: Java, published to Maven Central as
io.floci:testcontainers-floci. - testcontainers-floci-python: Python.
- testcontainers-floci-node: Node.js.
- testcontainers-floci-go: Go.
Real engines, not mocks. Lambda, RDS, ElastiCache, ECS, EC2, EKS, MSK, OpenSearch, ECR, and CodeBuild spin up real Docker containers and speak real wire protocols (RESP, JDBC, k8s, IMDS). IAM auth and SigV4 validation work the same as production AWS. The same philosophy carries over to Azure Functions and Cloud Functions in the sibling emulators.
Drop-in replacement. Same ports. Same wire protocols. Switch from LocalStack, Azurite, or gcloud emulators by changing your endpoint URL with zero application code changes.
Consistent across clouds. Same Quarkus Native foundation, same storage architecture (memory / hybrid / persistent / WAL), same Testcontainers patterns. Learn one Floci, you've learned them all.
- 💬 Join Slack for questions, feedback, and popcorn-fueled brainstorms
- 🗣️ GitHub Discussions for feature ideas, design tradeoffs, and half-baked thoughts
- 🐛 Open an issue on the cloud you're using: AWS · Azure · GCP
- 📖 Read the docs for quick start guides, configuration, and per-service details
Everything in this org is MIT licensed. Fork it, embed it, ship it. No "community edition" sunset. No enterprise feature flags.
Built with Quarkus + GraalVM Mandrel · Made for developers who ship.