AWS Cloud Emulator Floci

🗒️ Floci (Local Cloud Emulators)

Floci is a family of fast, free, open-source local cloud emulators (built using Quarkus Native) that act as an alternative to platforms like LocalStack. It lets you spin up mock environments for AWS, Azure, GCP, and Oracle Cloud (OCI) directly on your laptop without needing an internet connection, a credit card, or cloud credentials.

🚀 Core Benefits for Local Testing

Zero Cost & Setup: No auth tokens, API keys, subscription locks, or telemetry tracking.
Ultra-Fast & Light: Starts up in ~24 milliseconds and consumes roughly 13 MB of idle memory.
No Code Changes: It uses the same APIs, wire protocols, and ports as live cloud vendors. You simply point your existing SDK, CLI, or IaC tool (like Terraform) to localhost.

💻 Quick Start via Docker

You can run any of the emulators as isolated containers using standard docker run commands:

# Run AWS Emulator (Port 4566) - Matches standard LocalStack ports
docker run --rm -p 4566:4566 floci/floci:latest

# Run Azure Emulator (Port 4577)
docker run --rm -p 4577:4577 floci/floci-az:latest

# Run Google Cloud Emulator (Port 4588)
docker run --rm -p 4588:4588 floci/floci-gcp:latest

# Run Oracle Cloud Emulator (Port 4599)
docker run --rm -p 4599:4599 floci/floci-oci:latest

🛠️ How to Connect Your Application

Spin up the container for the specific cloud ecosystem your app utilizes.
Redirect your application SDK / CLI client by setting the custom endpoint URL to your local fallback (e.g., http://localhost:4566 for AWS).
Use dummy values for your environment variables; the emulator accepts any mock credentials.

Example: Interacting with Local AWS S3 via AWS CLI

# 1. Point your client to the local Floci port
export AWS_ENDPOINT_URL="http://localhost:4566"
export AWS_ACCESS_KEY_ID="mock-key"
export AWS_SECRET_ACCESS_KEY="mock-secret"
export AWS_DEFAULT_REGION="us-east-1"

# 2. Interact normally with your resources safely offline
aws s3 mb s3://my-test-bucket
aws s3 cp document.txt s3://my-test-bucket/

🔍 Ecosystem Tools

floci-cli: A singular command-line tool to manage starting and stopping different cloud services.
floci-ui: A visual web console dashboard allowing you to inspect your local databases, S3 buckets, and runtime logs dynamically.
testcontainers-floci: Native code packages available for Java, Python, Node.js, Go, and .NET to seamlessly manage lifecycle containers directly inside integration tests.

2.7 KiB Raw Permalink Blame History