# fakecloud

> fakecloud is a free, open-source local AWS cloud emulator written in Rust. It runs on a single port (4566), requires no account or auth token, and aims for 100% behavioral parity with real AWS on every service it implements. It is an open-source alternative to LocalStack, which went proprietary in March 2026.

- Single binary, no Docker required, starts in under 100ms
- 12 AWS services: S3, SQS, SNS, EventBridge, IAM/STS, SSM, DynamoDB, Lambda, Secrets Manager, CloudWatch Logs, KMS, CloudFormation
- Cross-service delivery: S3 notifications to SNS/SQS, SNS fan-out to SQS, EventBridge rules to SNS/SQS
- Scheduled EventBridge rules (cron and rate) that actually fire
- Conformance tested against real AWS behavior
- AGPL-3.0 licensed, free for commercial use

## Install

- [Install script](https://raw.githubusercontent.com/faiscadev/fakecloud/main/install.sh): `curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/install.sh | bash`
- [Cargo install](https://crates.io/crates/fakecloud): `cargo install fakecloud`
- [Docker](https://github.com/faiscadev/fakecloud/pkgs/container/fakecloud): `docker run -p 4566:4566 ghcr.io/faiscadev/fakecloud`

## Usage

- [Quick start](https://fakecloud.dev#quickstart): Run `fakecloud` then point any AWS SDK at `http://localhost:4566`
- [Configuration](https://github.com/faiscadev/fakecloud#configuration): CLI flags and environment variables (--addr, --region, --account-id, --log-level)
- [Health check](https://github.com/faiscadev/fakecloud#health-check): `curl http://localhost:4566/_fakecloud/health`

## Supported Services

- [S3](https://github.com/faiscadev/fakecloud#s3-74-actions): 74 actions — buckets, objects, multipart uploads, versioning, lifecycle, CORS, notifications, object lock
- [SQS](https://github.com/faiscadev/fakecloud#sqs-20-actions): 20 actions — queues, messages, long polling, FIFO, dead-letter queues, batch operations
- [SNS](https://github.com/faiscadev/fakecloud#sns-34-actions): 34 actions — topics, subscriptions, publishing, filter policies, SQS fan-out, HTTP delivery
- [EventBridge](https://github.com/faiscadev/fakecloud#eventbridge-41-actions): 41 actions — event buses, rules, targets, archives, replays, connections, API destinations
- [IAM/STS](https://github.com/faiscadev/fakecloud#iam--sts-135-actions): 135 actions — users, roles, groups, policies, instance profiles, identity providers, MFA, STS
- [SSM](https://github.com/faiscadev/fakecloud#ssm-46-actions): 46 actions — parameters, documents, commands, maintenance windows, patch baselines
- [DynamoDB](https://github.com/faiscadev/fakecloud#supported-services): Table and item operations
- [Lambda](https://github.com/faiscadev/fakecloud#lambda-10-actions-stub): 10 actions — function CRUD, stub invoke (does not execute code)
- [Secrets Manager](https://github.com/faiscadev/fakecloud#secrets-manager-11-actions): 11 actions — secret CRUD, versioning, soft delete, restore
- [CloudWatch Logs](https://github.com/faiscadev/fakecloud#cloudwatch-logs-14-actions): 14 actions — log groups, streams, events, filtering, retention
- [KMS](https://github.com/faiscadev/fakecloud#kms-16-actions): 16 actions — keys, encryption/decryption, aliases, data key generation
- [CloudFormation](https://github.com/faiscadev/fakecloud#cloudformation-8-actions): 8 actions — stacks, resource provisioning, template parsing, intrinsic functions

## Optional

- [Source code](https://github.com/faiscadev/fakecloud): GitHub repository
- [Architecture](https://github.com/faiscadev/fakecloud#architecture): Cargo workspace structure and protocol details
- [Contributing](https://github.com/faiscadev/fakecloud#contributing): Contribution guidelines
- [Comparison](https://github.com/faiscadev/fakecloud#comparison): Feature comparison with LocalStack, Floci, and MiniStack