explaingit

floci-io/floci

Analysis updated 2026-08-13

19,849JavaAudience · ops devopsComplexity · 2/5LicenseSetup · easy

TLDR

A free, open source local AWS emulator you run with Docker or a CLI, giving you real AWS-shaped services on your machine with no account or auth token.

Mindmap

mindmap
  root((repo))
    What it does
      Local AWS emulator
      No account needed
      Real Docker backed services
    Tech stack
      Java
      Docker
      AWS SDK compatible
    Use cases
      Local development against AWS APIs
      CI test pipelines
      Replace LocalStack Community
    Audience
      Developers
      DevOps engineers
    Setup
      CLI or Docker Compose
      Point tools at local port

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run AWS-shaped services locally for development without a cloud account

USE CASE 2

Point CI test pipelines at a local AWS emulator instead of real AWS

USE CASE 3

Switch away from LocalStack Community after it began requiring auth tokens

USE CASE 4

Test Terraform, CDK, or OpenTofu infrastructure code against a local emulator

What is it built with?

JavaDockerAWS SDKTerraformCDK

How does it compare?

floci-io/flocireactivex/rxandroidjetbrains/intellij-community
Stars19,84919,97520,091
LanguageJavaJavaJava
Setup difficultyeasyeasyhard
Complexity2/52/55/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice, under the MIT license.

In plain English

Floci is a free, open source local emulator for AWS services, built for development, testing, and continuous integration. It lets you run AWS shaped services on your own machine without needing a real AWS account, an auth token, or any paid feature gates. You point your normal AWS SDK, the AWS CLI, Terraform, CDK, or OpenTofu at a local address, and your existing tools and workflows keep working exactly as they would against real AWS. Getting started is a single command through Floci's own CLI, or a Docker Compose file if you prefer that route. Once it is running, you export a few environment variables and then run ordinary AWS commands, such as creating an S3 bucket or a DynamoDB table, against your local machine instead of the cloud. All services are reachable through one local port, and credentials can be any placeholder values unless you turn on stricter checks yourself. The README positions Floci as a direct response to changes at LocalStack, whose free community edition was sunset and now requires an auth token, with security updates frozen. Floci is offered as a no strings attached alternative: no auth token requirement, ongoing security updates, and an MIT license rather than a restricted one. It claims a small footprint, with a roughly 40 megabyte native binary, fast startup, and low idle memory use, and says several services, including Lambda, RDS, Neptune, ElastiCache, ECS, EC2, and EKS, run against real Docker containers rather than shallow simulations, which increases fidelity compared to mocked behavior. Storage can be configured as in-memory, persistent, hybrid, or write-ahead log, depending on how much durability you need between runs. The project reports supporting around 69 AWS services across categories like core app services, event and workflow tools, API and identity services, container and compute services, and data and analytics tools. It is written in Java and packaged as a Docker image as well as a native binary. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Install Floci and show me how to start it with Docker Compose in my project
Prompt 2
Explain how Floci differs from LocalStack Community and why I might switch
Prompt 3
Show me how to configure my AWS CLI and SDK to point at a local Floci instance
Prompt 4
Walk me through creating an S3 bucket and DynamoDB table against Floci locally

Frequently asked questions

What is floci?

A free, open source local AWS emulator you run with Docker or a CLI, giving you real AWS-shaped services on your machine with no account or auth token.

What language is floci written in?

Mainly Java. The stack also includes Java, Docker, AWS SDK.

What license does floci use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, under the MIT license.

How hard is floci to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is floci for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.