MiniStack: Open‑Source LocalStack Alternative Simulating 40+ AWS Services

Core Highlights

1. Single port for 40+ AWS services

MiniStack simulates more than 40 AWS services on port 4566.

Supported core services include:

S3 (full support: versioning, encryption, lifecycle, CORS, ACL, tags, policies, notifications, logging, multipart upload, object lock)

SQS (standard and FIFO queues, dead‑letter queue)

SNS (topics, subscriptions, notifications)

Lambda (local execution and Docker execution modes)

DynamoDB (full CRUD and secondary indexes)

EC2 (instances, security groups, VPC, subnets)

Step Functions (state machines + TestState API)

EventBridge (event bus + rules)

Kinesis (data streams + records)

SSM Parameter Store

Secrets Manager

IAM, STS, CloudFormation, CloudWatch Logs, CloudWatch Metrics, RDS, ElastiCache, Athena, ECS, EKS, API Gateway, Route 53, CloudFront, Cognito, SES, CloudTrail, Config, X‑Ray, MSK, EFS, FSx, Neptune, DocumentDB, Redshift, Timestream, Qldb, Glue, Batch, OpsWorks, Direct Connect, Transit Gateway, VPC Lattice

2. Real infrastructure, not just mocks

MiniStack launches real containers for infrastructure components, ensuring local behavior matches real AWS:

RDS: real PostgreSQL/MySQL containers

ElastiCache: real Redis container

Athena: real SQL queries via DuckDB

ECS: real Docker containers

Lambda: both local and Docker execution modes

This makes local development almost identical to running on actual AWS.

3. Extremely lightweight and fast

Resource usage comparison with LocalStack:

Docker image size: ~270 MB vs ~1 GB

Idle memory consumption: ~21 MB vs ~500 MB

Startup time: < 2 seconds vs 10‑30 seconds

HTTP/2 support: ✅ (h2c) vs ❌

4. Drop‑in compatibility

MiniStack uses the same port (4566) and API as LocalStack, so existing tooling works with only endpoint changes:

boto3: replace endpoint_url AWS CLI: --endpoint-url=http://localhost:4566 Terraform: modify provider configuration

CDK / Pulumi: no code changes required

Any AWS SDK: direct compatibility

Migration from LocalStack to MiniStack typically requires a single line change.

5. Multi‑tenant isolation

Lightweight multi‑tenant support is enabled via environment variables only:

export AWS_ACCESS_KEY_ID=custom_value
export AWS_SECRET_ACCESS_KEY=custom_value
aws --endpoint-url=http://localhost:4566 sts get-caller-identity

6. Rich internal API

MiniStack provides extensive internal APIs for test automation, with official examples available in the repository.

Quick Start

Method 1: PyPI (simplest)

pip install ministack
ministack
# runs at http://localhost:4566

Method 2: Docker (recommended)

# lightweight version
docker run -p 4566:4566 ministackorg/ministack

# with real infrastructure (RDS, ECS, Lambda containers)
docker run -p 4566:4566 -v /var/run/docker.sock:/var/run/docker.sock ministackorg/ministack

# full version (includes DuckDB, psycopg2, pymysql)
docker run -p 4566:4566 ministackorg/ministack:full

Method 3: Build from source

git clone https://github.com/ministackorg/ministack
cd ministack
docker compose up -d

Verify the installation with curl http://localhost:4566/_ministack/health.

Usage Scenarios

Typical use cases include local AWS development, CI/CD testing, Terraform local development, and multi‑tenant isolation development.

Comparison with LocalStack

License: MIT vs SSPL (community)

Image size: ~270 MB vs ~1 GB

Memory usage: ~21 MB vs ~500 MB

Startup time: < 2 s vs 10‑30 s

HTTP/2: supported vs not supported

Real databases: RDS/Redis/DuckDB vs partial support

Multi‑tenant: out‑of‑the‑box vs requires configuration

Drop‑in compatibility: same port 4566 vs same

Terraform support: full vs full

Conclusion

If you need an open‑source, lightweight, and fast AWS local emulator, MiniStack is the preferred choice.

References

GitHub: https://github.com/ministackorg/ministack

StackPort: https://github.com/DaviReisVieira/stackport

Official site: https://ministack.org

Docker Hub: https://hub.docker.com/r/ministackorg/ministack