Floci: An Open-Source Local AWS Emulator

Floci is a free, open-source local AWS emulator designed for development, testing, and continuous integration (CI) workflows. It provides AWS-shaped services directly on a local machine without requiring a cloud account, an authentication token, or paid feature gates. Users can point standard AWS clients, SDKs, CLIs, Terraform, CDK, OpenTofu, or test suites at http://localhost:4566 while keeping their existing workflows.

According to the project documentation, Floci serves as a drop-in replacement for LocalStack community setups, allowing users to swap the image and continue operating. The project offers broad service coverage, including application services, data services, eventing, identity, infrastructure, billing, and container-backed workloads. For stateful databases and complex runtimes, Floci utilizes real Docker-backed execution rather than shallow mocks.

Getting Started and Quick Start

The fastest way to run Floci is by using Docker Compose or the official command-line interface (CLI). Each release also ships as a standalone `floci-aws` binary for Linux, macOS, and Windows for environments without Docker.

• Start the emulator locally using Docker Compose or the CLI.
• Export the local AWS environment variables.
• Direct your standard AWS tooling to `http://localhost:4566`.

Key Architecture and Features

• Storage Flexibility: Configure storage modes such as in-memory, persistent, hybrid, or write-ahead logs depending on durability requirements.
• Multi-Account Isolation: Floci supports per-account resource isolation. If `AWS_ACCESS_KEY_ID` is exactly 12 digits, it is treated as the account ID, ensuring resources created by one account remain invisible to another.
• Web Console: Floci includes a browser console accessible at `http://localhost:4566/_floci/ui` for inspecting local resources through a sidecar container.
• Testcontainers Integration: Dedicated modules allow developers to start isolated instances directly from tests to avoid shared state and port conflicts.

Compatibility and Release Channels

Floci translates LocalStack environment variables automatically and maintains compatibility endpoints to support existing migration paths. Stable releases are scheduled on the 15th and the last day of each month, while nightly tags track the main branch for development builds.

Users can verify original installation instructions, compatibility matrices, and storage configurations directly on the official GitHub repository at `https://github.com/floci-io/floci`