floci-io /floci
Light, fluffy, and always free - The AWS Local Emulator alternative
★ 31,865⑂ 3,518👁 92⑃ 5,965● 2,613▤ 63
31,865
stars
3,518
forks
92
watchers
5,965
prs
2,613
issues
63
releases
README
Any Cloud. Locally.
Light, fluffy, and always free
No account. No auth token. No feature gates. Just docker compose up.
Quick Start ·
Features ·
Services ·
SDKs ·
Testcontainers ·
Migration ·
Docs
---
What is Floci?
Floci is a free, open-source local AWS emulator for development, testing, and CI.
It gives you AWS-shaped services on your machine without requiring a cloud account, an auth token, or paid feature gates. Point your AWS SDK, CLI, Terraform, CDK, OpenTofu, or test suite at http://localhost:4566 and keep your existing workflows.
Already using LocalStack? Floci is a drop-in replacement: swap the image and keep going. See Migrating from LocalStack.
Floci is the AWS member of the Floci emulator family, named after floccus, the cloud formation that looks like popcorn.
| Emulator | Cloud | Port |
|---|---|:---:|
| floci | AWS | 4566 |
| floci-az | Azure | 4577 |
| floci-gcp | GCP | 4588 |
| floci-oci | OCI | 4599 |
Quick Start
The fastest way to run Floci is with the official CLI
bash
floci start
No Docker? Each release also ships a standalone floci-aws
binary for Linux, macOS and Windows; see Native binary.
Export the AWS environment variables:
bash
eval $(floci env)
Use your existing AWS tools normally:
bash
aws s3 mb s3://my-bucket
aws dynamodb create-table \
--table-name demo-table \
--attribute-definitions AttributeName=pk,AttributeType=S \
--key-schema AttributeName=pk,KeyType=HASH \
--billing-mode PAY_PER_REQUEST
aws dynamodb list-tables
Watch it run
This short demo shows the CLI flow: start Floci, export the local AWS environment, run standard AWS CLI commands, and stop the emulator.
https://github.com/user-attachments/assets/b55714dc-ef36-40ae-a734-cd2cadc288a8
All AWS services are available at http://localhost:4566. Any published AWS region works, in every partition. Credentials can be any non-empty values unless you explicitly enable stricter service-specific auth checks.
Prefer Docker Compose?
Create a compose.yaml file:
yaml
services:
floci:
image: floci/floci:latest
ports:
- "4566:4566"
Start Floci:
bash
docker compose up
Then configure your AWS environment manually:
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
Using the old hectorvent/floci image?
Update your image name:
yaml
Before
image: hectorvent/floci:latest
After
image: floci/floci:latest
The old hectorvent/floci repository no longer receives updates.
Web Console
Floci ships a browser console for inspecting the resources in your local emulator.
Open it at: http://localhost:4566/_floci/ui
Nothing runs at boot. The first request pulls the console image, starts it as a sidecar container on Floci's Docker network, hands it Floci's own reachable address plus the standard AWS environment, polls its health endpoint, and redirects the browser once it repoTop issues
#4527[FLAKY] Docker-backed tests fail on ECR Public "toomanyrequests: Data limit exceeded" in the Build and Test shards6 comments · 2026-09-27#4565[FEAT] nix support5 comments · 2026-09-28#8361[FEAT] S3 gateway endpoint transport and IAM network context for EC2 guests4 comments · 2026-11-14#8220[BUG] Mutating operations ignore DryRun and make the change (DeleteVpc, ReleaseAddress, AuthorizeSecurityGroupIngress, ...)4 comments · 2026-11-13#7481[BUG] Pipes with a Kinesis source never match a `data` filter or resolve `<$.data>`4 comments · 2026-11-04#7422EC2: joining a VPC network can take Floci's default route, and DeleteVpc never answers4 comments · 2026-11-03#6606[FEAT] CloudFormation: one property contract for NoValue, removed properties and writable-property coverage4 comments · 2026-10-26#4999docs: the Actions column in services/index.md is hand-maintained and has drifted4 comments · 2026-10-03
Discussions
#8566Turkish video about floci (with English subtitles)0 comments · 2026-11-16#8094Support Kinesis Data Streams as an EventBridge rule target1 comments · 2026-11-12#7975Why is IAM enforcement off by default when the test key already bypasses it?3 comments · 2026-11-11#7495Proposal: optional external cryptographic backend for KMS1 comments · 2026-11-04#6755Any thoughts on a Hetzner emulator?1 comments · 2026-10-27#6590Floci's Java package is moving to io.floci.aws2 comments · 2026-10-26#5884Socket Security Advisory for Skill1 comments · 2026-10-17#5795Running workloads in microvms instead of docker2 comments · 2026-10-16
Latest release
2.5.0 2.5.0 2026-11-152.5.0 (2026-11-15) Features accessanalyzer: add basic ValidatePolicy checks (7085) (eb65ad8) account: implement GetContactInformation and PutContactInformation (8262) (5f03ff9) add CloudWatch OTLP metrics ingestion (7781) (2d8cdeb) apigateway: add documentation part operations (7712) (856970a) apigateway: trust FLOCI_TLS_EXTRA_CA_PATH for HTTP and HTTP_PROXY integrations (8285) (b2bdb2b) apigatewayv2: support IntegrationSubtype and invoke SQS-SendMessage on HTTP APIs (7969) (8eaf5bf) appconfig: implement UpdateApplication (7209) (1b87483) appsync: execute HTTP data sources and signe