Skip to content
@floci-io

Floci

Any Cloud. Locally.
floci-white floci-black

Any cloud. Locally.

Light, fluffy, and always free. Local cloud emulators for AWS, Azure, GCP, and OCI.

stars floci stars floci-az stars floci-gcp stars floci-oci License Slack Website

What is Floci™?

Floci is a family of fast, free, open-source local cloud emulators built with Quarkus Native, with one container per cloud, one port each, no auth tokens, no feature gates, no telemetry. Around the emulators sits a consistent set of client libraries, tooling, and validation so the whole suite feels like one project.

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 Cloud
docker run --rm -p 4599:4599 floci/floci-oci:latest    # Oracle Cloud

No sign-ups. No API keys. Point your existing SDK or CLI at the local endpoint and keep your workflows.

The suite

Category Repos
Emulators floci (AWS, :4566) · floci-az (Azure, :4577) · floci-gcp (GCP, :4588) · floci-oci (OCI, :4599)
Client libraries testcontainers-floci (Java) · -python · -node · -go · -dotnet
Tooling floci-cli · floci-ui
Docs & experimental floci-io.github.io · floci-duck

The four emulators

  • ☁️ AWS · floci · port 4566 · image floci/floci. EC2, ECS, EKS, Lambda, RDS, ElastiCache, MSK, OpenSearch, S3, DynamoDB, SQS, SNS, IAM, STS, KMS, Step Functions, CloudFormation, and more, validated against its compatibility test suite.
  • ☁️ Azure · floci-az · port 4577 · image floci/floci-az. Blob, Queue, Table, Cosmos DB, Functions, App Configuration, Key Vault, Event Hubs, Azure SQL Database, AKS, and Virtual Machines on a single endpoint.
  • ☁️ GCP · floci-gcp · port 4588 · image floci/floci-gcp. Cloud Storage, Pub/Sub, Firestore, Datastore, Secret Manager, IAM, and Managed Kafka on a single endpoint.
  • ☁️ OCI · floci-oci · port 4599 · image floci/floci-oci. Identity, Object Storage, Queue, Streaming, Vault + KMS, Secrets, and Functions on a single endpoint.

Always free, no feature gates, MIT forever

Every emulated service is available to every user, always: no auth tokens, no paid unlocks, no "community edition" sunset. The emulators are MIT-licensed and stay that way. Fork them, embed them, ship them.

Release train

Stable releases ship on the 1st and 3rd Tuesday of each month, across all four emulators. Between trains, the nightly tag on each image (floci/floci, floci/floci-az, floci/floci-gcp, floci/floci-oci) tracks main, so every merged fix is available the next day, and dated nightly-mmddyyyy tags let you pin a specific night's build.

Versions come from Conventional Commits by way of semantic-release, and every CHANGELOG.md is generated rather than written by hand.

Sponsors

Floci is independent open source, funded by the people and companies who use it. Sponsorship buys gratitude and nothing else: every emulated service is free for everyone, forever, and no sponsor gets features, priority, or roadmap influence that the rest of the Flock does not.

🥇 Gold

Large logo with top placement in the emulator READMEs and on floci.io, plus a mention in release notes.

IceGuard · Softmax

🥈 Silver

Logo in the emulator READMEs and on floci.io, plus a mention in release notes.

Your logo here. Become a sponsor.

🥉 Community

Name in the emulator READMEs, a sponsor badge on GitHub, and our sincere thanks.

AutoScout24 · Nexxion AI

Every sponsor, including the Friends of the Flock who support Floci outside these tiers, is listed in THANKS.md.

Sponsor Floci

Links

Website · Documentation · Slack · Discussions · Governance · Trademark


Built with Quarkus + GraalVM Mandrel · Made for developers who ship.

Floci™ is a trademark of Hector Ventura. Code is MIT-licensed; see TRADEMARK.md for name and logo use.

Pinned Loading

  1. floci floci Public

    Light, fluffy, and always free - The AWS Local Emulator alternative

    Java 26.5k 2.9k

  2. testcontainers-floci testcontainers-floci Public

    Light, fluffy, and always free - Testcontainers for Java: run the Floci local AWS and Azure emulators in your integration tests.

    Java 65 15

  3. testcontainers-floci-python testcontainers-floci-python Public

    Light, fluffy, and always free - Testcontainers for Python: run the Floci local AWS emulator in your integration tests.

    Python 13 9

Repositories

Showing 10 of 18 repositories
  • floci-oci Public

    Light, fluffy, and always free - Local Oracle Cloud Emulator

    floci-io/floci-oci's past year of commit activity
    Java 102 MIT 28 1 3 Updated Oct 7, 2026
  • floci Public

    Light, fluffy, and always free - The AWS Local Emulator alternative

    floci-io/floci's past year of commit activity
    Java 26,534 MIT 2,874 143 109 Updated Oct 7, 2026
  • testcontainers-floci-node Public

    Light, fluffy, and always free - Testcontainers for Node.js: run the Floci local AWS emulator in your integration tests.

    floci-io/testcontainers-floci-node's past year of commit activity
    TypeScript 9 MIT 7 0 0 Updated Oct 6, 2026
  • testcontainers-floci-go Public

    Light, fluffy, and always free - Testcontainers for Go: run the Floci local AWS emulator in your integration tests.

    floci-io/testcontainers-floci-go's past year of commit activity
    Go 7 MIT 5 0 1 Updated Oct 7, 2026
  • testcontainers-floci Public

    Light, fluffy, and always free - Testcontainers for Java: run the Floci local AWS and Azure emulators in your integration tests.

    floci-io/testcontainers-floci's past year of commit activity
    Java 65 MIT 15 1 2 Updated Oct 7, 2026
  • testcontainers-floci-python Public

    Light, fluffy, and always free - Testcontainers for Python: run the Floci local AWS emulator in your integration tests.

    floci-io/testcontainers-floci-python's past year of commit activity
    Python 13 MIT 9 0 0 Updated Oct 7, 2026
  • testcontainers-floci-dotnet Public

    Light, fluffy, and always free - Testcontainers for .NET: run the Floci local AWS emulator in your integration tests.

    floci-io/testcontainers-floci-dotnet's past year of commit activity
    C# 8 MIT 5 1 10 Updated Oct 6, 2026
  • floci-io.github.io Public

    Any Cloud. Locally - Local Emulators

    floci-io/floci-io.github.io's past year of commit activity
    Astro 25 14 0 0 Updated Oct 6, 2026
  • floci-az Public

    Light, fluffy, and always free - Local Azure Emulator

    floci-io/floci-az's past year of commit activity
    Java 746 MIT 132 20 7 Updated Oct 6, 2026
  • floci-gcp Public

    Light, fluffy, and always free - GCP Local Emulator

    floci-io/floci-gcp's past year of commit activity
    Java 442 MIT 99 38 19 Updated Oct 6, 2026