Developer tools#Containers

floci: a free local AWS emulator that replaces LocalStack outright

floci runs AWS-shaped services locally with one docker compose up — no account, no token, no paywall. SDKs, Terraform and tests point at port 4566. MIT.

Project facts

GitHub Ecosystem
Repositorygithub.com/floci-io/floci
License
MIT
Language
Java
Stars
29,648
Data checked
2026-11-05

Snapshot figures reflect the check date and may change over time.

Local development against AWS means either risking a real account or living inside LocalStack’s account, token and paywall. floci (MIT, 29,648 stars as of November 5, 2026) offers a third way: one docker compose up and your machine runs AWS-shaped services — no account, no auth token, no feature gates. Point your AWS SDK, CLI, Terraform, CDK, OpenTofu or test suite at http://localhost:4566 and keep every existing workflow. It is also a drop-in LocalStack replacement: swap the image name and continue.

Core features

  • Zero-gate local cloud: no cloud account, no token; runs in CI, and test environments stay naturally separated from production configuration — no more fighting over a shared account’s concurrency limits.
  • LocalStack drop-in: a dedicated migration guide — swap the image, keep the workflows.
  • SDK-native: AWS SDK, CLI, Terraform, CDK, OpenTofu and Testcontainers all connect to port 4566 the usual way.
  • A family: sibling projects include floci-az (a local Azure emulator) and floci-ui, a web console for the local cloud.

Typical use cases

  • Integration tests: spin up S3/SQS-shaped services in CI without spend or external calls; every PR gets its own isolated instance.
  • IaC rehearsals: validate Terraform/OpenTofu plans locally before touching the real account, avoiding plan-is-mutation accidents.
  • Offline development: travel and air-gapped environments stop being blocked on cloud reachability.
  • Testcontainers integration: the repo ships a Testcontainers section, so JVM test suites attach to port 4566 directly.

Quick start

docker compose up

Then point AWS endpoints at http://localhost:4566; LocalStack users can follow the repo’s Migrating section to swap images. Official Docker images publish as floci/floci, releases are built automatically by GitHub Actions with build badges attached, and upgrades can simply track the latest tag. A sibling floci-ui project adds a web console for inspecting whatever state your tests leave behind.

Summary

floci fits test and CI loops that frequently need AWS-shaped dependencies; teams needing the full service catalog or production-fidelity emulation details should still weigh LocalStack’s paid tiers. Facts and limits: MIT, Java implementation, 29,648 stars since the repo opened in February 2026, with official Docker images published as floci/floci; a local emulator does not reproduce real-cloud quotas, throttling and regional behavior, so load tests and cost estimates still belong on real AWS; check the Services section of the repo before migrating to confirm coverage of what you use. It rides the same trend as agent-autoloop on this site — capabilities that used to require the cloud are moving back onto your machine: autoloop pulls the always-running agent onto one box, floci pulls the development cloud into one container.