Skip to main content
Floci runs 25 AWS services on a single port (4566) using the real AWS wire protocol. Point your existing AWS SDK or CLI at http://localhost:4566 — no code changes needed.
Named after floccus — the cloud formation that looks exactly like popcorn.

Quick Start

Get Floci running and verify AWS CLI commands in under 5 minutes

Installation

Docker, native binary, or build from source

Services

25 AWS services — Lambda, S3, DynamoDB, RDS, and more

Configuration

Environment variables, storage modes, and Docker Compose setup

​
Why Floci?

LocalStack’s community edition sunset in March 2026 — requiring auth tokens and freezing security updates. Floci is the no-strings-attached alternative.
FlociLocalStack Community
Auth token requiredNoYes (since March 2026)
Security updatesYesFrozen
Startup time~24 ms~3.3 s
Idle memory~13 MiB~143 MiB
Docker image size~90 MB~1.0 GB
LicenseMITRestricted
API Gateway v2 / HTTP API✅❌
Cognito✅❌
ElastiCache (Redis + IAM auth)✅❌
RDS (PostgreSQL + MySQL + IAM auth)✅❌
25 services. 408/408 SDK tests passing. Free forever.

​
Get running in 30 seconds

1

Start Floci

docker-compose.yml
services:
  floci:
    image: hectorvent/floci:latest
    ports:
      - "4566:4566"
    volumes:
      - ./data:/app/data

docker compose up -d
2

Configure your AWS client

Any dummy credentials work — no real AWS account needed.
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
3

Run your first command

aws s3 mb s3://my-bucket
aws sqs create-queue --queue-name my-queue
aws dynamodb list-tables

​
Supported services

Compute

Lambda (Docker-backed), API Gateway v1 & v2

Messaging

SQS, SNS, EventBridge, Kinesis

Storage

S3, DynamoDB, DynamoDB Streams, Secrets Manager, SSM

Security

IAM, STS, Cognito, KMS, ACM

Databases

RDS (PostgreSQL & MySQL), ElastiCache (Redis/Valkey)

Observability

CloudWatch Logs & Metrics, Step Functions, CloudFormation

Build docs developers (and LLMs) love

Get started for freeTalk to us