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 — requiring auth tokens and freezing 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 | — | — |
| Idle memory (AWS) | ~13 MiB | ~143 MiB | — | — |
| 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 + 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 — 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.
SDK source is the contract. Every service is validated against the actual SDK deserializers — not the prose docs. If the Rust SDK panics on an empty XML body (#11), that's a Floci bug. We fix the wire, not the docs.
Drop-in replacement. Same ports. Same wire protocols. Switch from LocalStack, Azurite, or gcloud emulators by changing your endpoint URL — 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 — questions, feedback, popcorn-fueled brainstorms
- 🗣️ GitHub Discussions — feature ideas, design tradeoffs, half-baked thoughts welcome
- 🐛 Open an issue on the cloud you're using — AWS · Azure · GCP
- 📖 Read the docs — quick start, configuration, per-service guides
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.