☁️ CloudDev

A free, open-source local AWS emulator — the self-hosted alternative to LocalStack.

CloudDev runs 23 AWS services locally as a single Go binary with zero runtime dependencies. Built for developers who want fast, offline AWS development without cloud costs or vendor lock-in.

✨ Features

23 AWS services emulated locally — S3, DynamoDB, Lambda, SQS (+ FIFO), SNS, API Gateway, IAM, STS, KMS, CloudFormation, Step Functions, EventBridge, Secrets Manager, CloudWatch Logs, CloudWatch Metrics, ElastiCache, Cognito, Lambda Layers, X-Ray, Route53, SSM Parameter Store, and Rekognition
Single binary — no Docker, no Python, no Java runtime required
Zero config — works out of the box with your existing AWS CLI and SDKs
Web dashboard — real-time service status cards at localhost:4580
IaC support — auto-detects Terraform, CloudFormation, and Kubernetes configs
Lambda hot reload — instant function updates without restarts
Data persistence — state survives restarts via ~/.clouddev/state.json
Cost estimator — see estimated AWS costs for your local workloads

🚀 Quick Start

Install

git clone https://github.com/Jeffrin-dev/CloudDev.git
cd CloudDev
go build -o clouddev .

Initialize and Start

./clouddev init my-app
cd my-app
../clouddev up

Use with AWS CLI

# S3
aws --endpoint-url=http://localhost:4566 s3 mb s3://my-bucket
 
# DynamoDB
aws --endpoint-url=http://localhost:4569 dynamodb list-tables
 
# KMS
aws --endpoint-url=http://localhost:4599 kms create-key --description "my-key"
 
# SSM Parameter Store
aws --endpoint-url=http://localhost:4583 ssm put-parameter \
    --name "/myapp/db/host" --value "localhost" --type String
 
# CloudWatch Metrics
aws --endpoint-url=http://localhost:4582 cloudwatch put-metric-data \
    --namespace "MyApp" --metric-name "RequestCount" --value 42 --unit Count
 
# Route53
aws --endpoint-url=http://localhost:4589 route53 create-hosted-zone \
    --name example.com --caller-reference ref-1
 
# X-Ray
aws xray put-trace-segments \
    --endpoint-url http://localhost:4588 \
    --trace-segment-documents '{"id":"seg-1","trace_id":"1-abc-123","name":"my-service"}'
 
# Lambda Layers
aws --endpoint-url=http://localhost:4578 lambda publish-layer-version \
    --layer-name my-layer --description "My layer" \
    --compatible-runtimes python3.9 go1.x \
    --content S3Bucket=my-bucket,S3Key=my-layer.zip
 
# Rekognition
aws --endpoint-url=http://localhost:4594 rekognition detect-labels \
    --image '{"S3Object":{"Bucket":"my-bucket","Name":"photo.jpg"}}'

📦 Services & Ports

| Service | Port | Version | |---|---|---| | S3 | 4566 | v0.1.0 | | DynamoDB | 4569 | v0.1.0 | | Lambda | 4574 | v0.1.0 | | SQS (+ FIFO) | 4576 | v0.1.0 / v0.4.0 | | API Gateway | 4572 | v0.1.0 | | Dashboard | 4580 | v0.1.0 | | SNS | 4575 | v0.2.0 | | Secrets Manager | 4584 | v0.2.0 | | CloudWatch Logs | 4586 | v0.2.0 | | IAM | 4593 | v0.3.0 | | STS | 4592 | v0.3.0 | | KMS | 4599 | v0.3.0 | | CloudFormation | 4581 | v0.3.0 | | Step Functions | 4585 | v0.3.0 | | EventBridge | 4587 | v0.3.0 | | ElastiCache (Redis) | 4598 | v0.3.0 | | ElastiCache (HTTP) | 4597 | v0.3.0 | | Cognito | 4596 | v0.3.0 | | CloudWatch Metrics | 4582 | v0.4.0 | | Lambda Layers | 4578 | v0.4.0 | | X-Ray | 4588 | v0.4.0 | | Route53 | 4589 | v0.4.0 | | SSM Parameter Store | 4583 | v0.4.0 | | Rekognition | 4594 | v0.4.0 |

🗂️ Project Structure

clouddev/
├── cmd/                    # CLI commands (up, init, status)
├── internal/
│   ├── config/             # Config parser (clouddev.yml)
│   ├── dashboard/          # Web dashboard
│   ├── docker/             # Docker manager
│   ├── iac/                # IaC parser (Terraform/CloudFormation/K8s)
│   ├── persist/            # State persistence
│   ├── costestimator/      # AWS cost estimator
│   └── services/
│       ├── s3/
│       ├── dynamodb/
│       ├── lambda/
│       ├── lambdalayers/
│       ├── sqs/
│       ├── sns/
│       ├── apigateway/
│       ├── iam/
│       ├── sts/
│       ├── kms/
│       ├── cloudformation/
│       ├── cloudwatchlogs/
│       ├── cloudwatchmetrics/
│       ├── stepfunctions/
│       ├── eventbridge/
│       ├── secretsmanager/
│       ├── elasticache/
│       ├── cognito/
│       ├── xray/
│       ├── route53/
│       ├── ssm/
│       └── rekognition/
├── clouddev.yml
├── go.mod
└── main.go

⚙️ Configuration

services:
  s3: true
  dynamodb: true
  lambda: true
  sqs: true
  api_gateway: true
 
ports:
  s3: 4566
  dynamodb: 4569
  lambda: 4574
  sqs: 4576
  api_gateway: 4572
 
lambda:
  functions_dir: ./functions
  hot_reload: true

🧪 Running Tests

go test ./...

🛣️ Roadmap

[ ] CloudWatch Events
[ ] SES email emulation
[ ] DynamoDB Streams
[ ] Lambda function URLs
[ ] API Gateway v2 (HTTP API)
[ ] Bedrock (mock LLM responses)

🤝 Contributing

We welcome contributions! Please read CONTRIBUTING.md to get started.

📄 License

Apache 2.0 — see LICENSE for details.

⭐ Star History

If CloudDev saves you time or money, please consider giving it a ⭐ on GitHub!

Built for devs

CloudDev

Install / Use

README