Repolode
Submit
floci-io

floci-io/floci

A free, open-source local AWS emulator that lets you run AWS-shaped services on your machine with no account or auth token.

Open-source alternative to:LocalStack

View on GitHubWebsite
Stars
26,947
Forks
2,954
Open issues
140
Last commit
9 hours ago

What is it?

Floci is a local AWS emulator for development, testing and CI. You point the AWS SDK, CLI, Terraform, CDK, OpenTofu or your test suite at http://localhost:4566 and keep existing workflows, without needing a cloud account, auth token or paid feature tiers.

It covers a broad set of AWS services, including S3, SQS, SNS, DynamoDB, Lambda, IAM, STS, Step Functions, API Gateway, Cognito and many more. Services such as Lambda, RDS, ElastiCache, MSK, ECS, EC2 and EKS run as real Docker containers rather than shallow mocks, which improves fidelity for those workloads. Storage can be in-memory, persistent, hybrid or write-ahead log, and it supports per-account isolation via the access key ID.

Floci also provides Testcontainers modules for Java, Node.js, Python and .NET, plus an official CLI and a browser console. It is positioned as a drop-in replacement for LocalStack Community, with a compatible image variant for init scripts that need the AWS CLI or boto3.

Key features

  • 01Works with standard AWS SDKs, CLI and IaC tools by changing only the endpoint.
  • 02Runs Lambda, RDS, ElastiCache, ECS, EC2 and EKS as real Docker-backed services.
  • 03Offers in-memory, persistent, hybrid and write-ahead log storage modes.
  • 04Isolates resources per account using a 12-digit access key ID.
  • 05Provides Testcontainers modules for Java, Node.js, Python and .NET.

Use cases

  • Running AWS-dependent application code and tests locally without a cloud account.
  • Running CI pipelines against emulated AWS services instead of real infrastructure.
  • Testing Terraform, CDK or OpenTofu configurations before deploying to AWS.
  • Replacing LocalStack Community in existing Docker Compose setups.

Quick start

  1. 1

    Start Floci with the official CLI

    floci start
  2. 2

    Export the AWS environment variables

    eval $(floci env)
  3. 3

    Run standard AWS CLI commands against Floci

    aws s3 mb s3://my-bucket

Things to know

  • Some services use real Docker-backed execution, so they need a running Docker engine and the Docker socket.
  • The README's "Web Console" feature requires mounting the Docker socket into the container.

Topics

#aws#local-development#testing#docker#emulator#devops#ci-cd#aws-emulation#ec2#ecs

FAQ

What is floci?
A free, open-source local AWS emulator that lets you run AWS-shaped services on your machine with no account or auth token. Floci is a local AWS emulator for development, testing and CI. You point the AWS SDK, CLI, Terraform, CDK, OpenTofu or your test suite at http://localhost:4566 and keep existing workflows, without needing a cloud account, auth token or paid feature tiers.
Is floci free to use? What license does it have?
floci is open source under the MIT license. Check the license terms before using it in commercial products.
Is floci still maintained?
Actively maintained. The last commit to floci was on Oct 20, 2026.
What can I use floci for?
Running AWS-dependent application code and tests locally without a cloud account. Running CI pipelines against emulated AWS services instead of real infrastructure. Testing Terraform, CDK or OpenTofu configurations before deploying to AWS. Replacing LocalStack Community in existing Docker Compose setups.
How do I install floci?
Start Floci with the official CLI: floci start Export the AWS environment variables: eval $(floci env) Run standard AWS CLI commands against Floci: aws s3 mb s3://my-bucket
Where can I get floci?
The source code and installation instructions are on GitHub: https://github.com/floci-io/floci

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects