# floci-io/floci

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/floci-io-floci).**

14,168 stars · 1,384 forks · Java · MIT

## Links

- GitHub: https://github.com/floci-io/floci
- Homepage: https://floci.io/floci/
- awesome-repositories: https://awesome-repositories.com/repository/floci-io-floci.md

## Topics

`aws` `aws-emulation` `devops` `docker` `ec2` `ecs` `localstack` `s3` `sqs` `testcontainers`

## Description

Floci is a local emulator for AWS services and cloud infrastructure designed for developing and testing applications without a live internet connection. It serves as a containerized cloud emulator and a serverless runtime emulator, allowing users to run high-fidelity replicas of cloud databases, queues, and compute services on a local machine.

The project distinguishes itself by using real container images instead of simple mocks to ensure behavioral accuracy. It functions as a local API gateway simulator with proxy-based routing for REST and WebSocket APIs, and provides a serverless environment featuring dynamic code reloading to iterate on functions without restarting the entire environment.

The emulator covers a wide range of capabilities, including the management of object storage, NoSQL tables, relational databases, and streaming clusters. It supports infrastructure-as-code testing and SDK compatibility verification, alongside identity management, event orchestration, and cryptographic key security.

The system integrates with test containers to manage isolated instances directly from test code, ensuring a clean state for every run.

## Tags

### Development Tools & Productivity

- [AWS Local Development Environments](https://awesome-repositories.com/f/development-tools-productivity/aws-local-development-environments.md) — Simulates AWS cloud services and infrastructure on a local machine to build and test applications without a live internet connection.
- [Cloud Service Emulators](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management/cloud-service-emulation-interception/cloud-infrastructure-emulation/cloud-service-emulators.md) — Implements a local environment that mimics cloud service behavior using real container images for high fidelity.
- [Dynamic Code Reloading](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management/cloud-service-emulation-interception/cloud-infrastructure-emulation/serverless-function-development-tools/dynamic-code-reloading.md) — Automatically refreshes emulated cloud function logic to enable rapid iteration without restarts. ([source](https://github.com/floci-io/floci/blob/main/docker-compose.yml))
- [Local Emulation Environments](https://awesome-repositories.com/f/development-tools-productivity/local-emulation-environments.md) — Provides a local environment for developing and testing applications by emulating AWS services and infrastructure without a live connection.
- [Local Function Execution](https://awesome-repositories.com/f/development-tools-productivity/local-function-execution.md) — Runs serverless functions using local runtimes with support for container images and instant code reloading. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [Client-Emulator Compatibility Verifiers](https://awesome-repositories.com/f/development-tools-productivity/command-line-http-clients/protocol-compatibility-verifiers/client-emulator-compatibility-verifiers.md) — Verify that cloud software development kits and command line tools interact correctly with the local emulator using real clients. ([source](https://github.com/floci-io/floci/blob/main/compatibility-tests))
- [Dynamic Logic Reloading](https://awesome-repositories.com/f/development-tools-productivity/dynamic-logic-reloading.md) — Automatically updates the logic of emulated cloud functions without restarting the local development environment.

### DevOps & Infrastructure

- [Cloud Service Emulators](https://awesome-repositories.com/f/devops-infrastructure/cloud-service-emulators.md) — Executes high-fidelity emulations of cloud compute and data services using real container images instead of mocks. ([source](https://github.com/floci-io/floci#readme))
- [Local Serverless Testing](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/serverless-execution-environments/serverless-function-runtimes/local-serverless-testing.md) — Executes and reloads serverless functions in a local runtime to iterate on code without deploying to the cloud.
- [Infrastructure Orchestration Templates](https://awesome-repositories.com/f/devops-infrastructure/container-orchestrators/infrastructure-orchestration-templates.md) — Deploys relational databases and streaming clusters by managing isolated container groups through integrated templates.
- [Serverless Runtimes](https://awesome-repositories.com/f/devops-infrastructure/serverless-runtimes.md) — Provides a local execution environment for serverless functions featuring dynamic code reloading and container image support.
- [Container Service Execution](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/execution-flow-controls/container-service-execution.md) — Uses real container images for compute and database services to ensure behavioral accuracy. ([source](https://github.com/floci-io/floci/blob/main/README.md))
- [Dynamic Runtime Reloading](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/serverless-execution-environments/serverless-function-runtimes/dynamic-runtime-reloading.md) — Allows updating serverless function logic instantly without restarting the entire emulator environment.
- [Streaming Cluster Emulation](https://awesome-repositories.com/f/devops-infrastructure/cluster-management/streaming-cluster-emulation.md) — Orchestrates containerized Kafka brokers to simulate high-throughput message distribution. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [Container Deployment](https://awesome-repositories.com/f/devops-infrastructure/container-deployment.md) — Orchestrates local container clusters with integrated load balancer registration. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [Automated Testing Containers](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-container-execution/automated-testing-containers.md) — Starts isolated emulator instances directly from test code via Testcontainers to ensure a clean state. ([source](https://github.com/floci-io/floci#readme))
- [Database Cluster Orchestration](https://awesome-repositories.com/f/devops-infrastructure/database-cluster-orchestration.md) — Provisions containerized relational databases and cache clusters to simulate production cloud environments. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [Event Pattern Emulation](https://awesome-repositories.com/f/devops-infrastructure/event-triggers/event-pattern-detection/event-pattern-emulation.md) — Processes event schedules and patterns with capabilities to archive and replay historical data streams. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [IaC Local Validation](https://awesome-repositories.com/f/devops-infrastructure/infrastructure-as-code/iac-local-validation.md) — Verifies that deployment scripts and cloud software development kits work correctly by targeting a local emulator instead of live resources.
- [Infrastructure Provisioning Templates](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-platform-as-a-service/infrastructure-provisioning-templates.md) — Deploys local resources using formatted infrastructure templates with support for transforms and cross-stack references. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))

### Networking & Communication

- [Protocol-Compatible Backends](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/api-management-integration/api-compatibility/protocol-compatible-backends.md) — Implements standard cloud provider API protocols to ensure compatibility with official SDKs and CLI tools.
- [Local Proxy Gateways](https://awesome-repositories.com/f/networking-communication/local-proxy-gateways.md) — Simulates API endpoints and network traffic via a local gateway with authorizers and custom domain mappings.
- [Cloud Protocol Emulation](https://awesome-repositories.com/f/networking-communication/service-emulators/cloud-protocol-emulation.md) — Implements wire protocols like JSON and REST to process cloud service requests and responses locally. ([source](https://github.com/floci-io/floci/blob/main/AGENTS.md))
- [Traffic Management Gateways](https://awesome-repositories.com/f/networking-communication/traffic-management-gateways.md) — Simulates REST and WebSocket API traffic using authorizers and proxy integrations to manage local network flow. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [Virtual Network Emulation](https://awesome-repositories.com/f/networking-communication/virtual-network-emulation.md) — Emulates cloud networks, subnets, and instances using containers with secure shell access. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))

### Testing & Quality Assurance

- [Infrastructure Testing Tools](https://awesome-repositories.com/f/testing-quality-assurance/testing-infrastructure-management/infrastructure-testing-tools.md) — Utility for verifying infrastructure as code scripts and SDK compatibility against local emulated endpoints. ([source](https://github.com/floci-io/floci/blob/main/compatibility-tests))
- [Test Isolation](https://awesome-repositories.com/f/testing-quality-assurance/general-testing-utilities/test-isolation.md) — Starts temporary emulator instances within test code to ensure a clean state and prevent network port conflicts.
- [SDK Compatibility Testing](https://awesome-repositories.com/f/testing-quality-assurance/sdk-compatibility-testing.md) — Verify that standard cloud software development kits interact correctly with the local emulator without requiring code changes. ([source](https://github.com/floci-io/floci/tree/main/compatibility-tests))

### Part of an Awesome List

- [Messaging and Queuing](https://awesome-repositories.com/f/awesome-lists/devops/messaging-and-queuing.md) — Simulates cloud queuing and notification systems for asynchronous communication. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))

### Content Management & Publishing

- [Ephemeral Test Instance Management](https://awesome-repositories.com/f/content-management-publishing/ephemeral-test-instance-management.md) — Starts and stops temporary emulator instances via language modules to ensure a clean state for every test run. ([source](https://github.com/floci-io/floci/blob/main/README.md))

### Data & Databases

- [Multi-Tenant Resource Isolation](https://awesome-repositories.com/f/data-databases/multi-tenant-resource-isolation.md) — Separates resource storage based on access keys to support multiple isolated tenants. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [Bucket Management](https://awesome-repositories.com/f/data-databases/object-storage/bucket-management.md) — Simulates object storage buckets with support for virtual addressing and static website hosting. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [NoSQL Table Emulation](https://awesome-repositories.com/f/data-databases/table-data-processing/nosql-table-emulation.md) — Emulates NoSQL database operations including specialized query languages and point-in-time recovery. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))

### Security & Cryptography

- [Cloud Key Emulators](https://awesome-repositories.com/f/security-cryptography/cryptographic-key-management/cloud-key-emulators.md) — Simulates key management operations including on-demand rotation and hash-based message authentication codes. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))
- [User Identity Management](https://awesome-repositories.com/f/security-cryptography/user-identity-management.md) — Emulates user and identity pools, including custom authentication flows and trigger functions for member access. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))

### Software Engineering & Architecture

- [State Machine Orchestrators](https://awesome-repositories.com/f/software-engineering-architecture/state-machine-orchestrators.md) — Runs state machine definitions using JSONata and nested executions to manage complex business logic flows. ([source](https://github.com/floci-io/floci/blob/main/CHANGELOG.md))

### System Administration & Monitoring

- [Account-Based Resource Isolation](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/account-based-resource-isolation.md) — Separates resources by account ID to ensure that different tests or users do not interfere. ([source](https://github.com/floci-io/floci#readme))