Floci

Latest Release Build Status Docker Pulls Docker Image Size License: MIT GitHub Stars

๐Ÿฟโ˜๏ธ Light, fluffy, and always free

Named after floccus โ€” the cloud formation that looks exactly like popcorn.

A free, open-source local AWS emulator. No account. No feature gates. No CI restrictions. Just docker compose up.

--- > LocalStack's community edition [sunset in March 2026](https://blog.localstack.cloud/the-road-ahead-for-localstack/) โ€” requiring auth tokens, and freezing security updates. Floci is the no-strings-attached alternative. ## Why Floci? | | Floci | LocalStack Community | |---|---|------------------------| | Auth token required | No | Yes (since March 2026) | | Security updates | Yes | Frozen | | Startup time | **~24 ms** | ~3.3 s | | Idle memory | **~13 MiB** | ~143 MiB | | Docker image size | **~90 MB** | ~1.0 GB | | License | **MIT** | Restricted | | API Gateway v2 / HTTP API | Yes | No | | Cognito | Yes | No | | ElastiCache (Redis + IAM auth) | Yes | No | | RDS (PostgreSQL + MySQL + IAM auth) | Yes | No | | S3 Object Lock (COMPLIANCE / GOVERNANCE) | Yes | Partial | | DynamoDB Streams | Yes | Partial | | IAM (users, roles, policies, groups) | Yes | Partial | | STS (all 7 operations) | Yes | Partial | | Kinesis (streams, shards, fan-out) | Yes | Partial | | KMS (sign, verify, re-encrypt) | Yes | Partial | | Native binary | Yes (~40 MB) | No | **20+ services. 408/408 SDK tests passing. Free forever.** ## Quick Start ```yaml # docker-compose.yml services: floci: image: hectorvent/floci:latest ports: - "4566:4566" volumes: - ./data:/app/data ``` ```bash docker compose up ``` All services are available at `http://localhost:4566`. Use any AWS region โ€” credentials can be anything. ```bash export AWS_ENDPOINT_URL=http://localhost:4566 export AWS_DEFAULT_REGION=us-east-1 export AWS_ACCESS_KEY_ID=test export AWS_SECRET_ACCESS_KEY=test # Try it aws s3 mb s3://my-bucket aws sqs create-queue --queue-name my-queue aws dynamodb list-tables ``` ## SDK Integration Point your existing AWS SDK at `http://localhost:4566` โ€” no other changes needed. ```java // Java (AWS SDK v2) DynamoDbClient client = DynamoDbClient.builder() .endpointOverride(URI.create("http://localhost:4566")) .region(Region.US_EAST_1) .credentialsProvider(StaticCredentialsProvider.create( AwsBasicCredentials.create("test", "test"))) .build(); ``` ```python # Python (boto3) import boto3 client = boto3.client("s3", endpoint_url="http://localhost:4566", region_name="us-east-1", aws_access_key_id="test", aws_secret_access_key="test") ``` ```javascript // Node.js (AWS SDK v3) import { S3Client } from "@aws-sdk/client-s3"; const client = new S3Client({ endpoint: "http://localhost:4566", region: "us-east-1", credentials: { accessKeyId: "test", secretAccessKey: "test" }, forcePathStyle: true, }); ``` ## Image Tags | Tag | Description | |---|---| | `latest` | Native image โ€” sub-second startup **(recommended)** | | `latest-jvm` | JVM image โ€” broadest platform compatibility | | `x.y.z` / `x.y.z-jvm` | Pinned releases | ## Configuration All settings are overridable via environment variables (`FLOCI_` prefix). | Variable | Default | Description | |---|---|---| | `QUARKUS_HTTP_PORT` | `4566` | HTTP port | | `FLOCI_DEFAULT_REGION` | `us-east-1` | Default AWS region | | `FLOCI_DEFAULT_ACCOUNT_ID` | `000000000000` | Default AWS account ID | | `FLOCI_STORAGE_MODE` | `hybrid` | `memory` ยท `persistent` ยท `hybrid` ยท `wal` | | `FLOCI_STORAGE_PERSISTENT_PATH` | `./data` | Data directory | โ†’ Full reference: [configuration docs](https://hectorvent.dev/floci/configuration/application-yml/) โ†’ Per-service storage overrides: [storage docs](https://hectorvent.dev/floci/configuration/storage/#per-service-storage-overrides) ## License MIT โ€” use it however you want.