MiniStack is an open-source local cloud emulator designed as a drop-in alternative to LocalStack, enabling developers to run and test AWS-like infrastructure entirely on their machine. It provides over 45 AWS-compatible services through a single local endpoint, allowing applications, SDKs, and infrastructure-as-code tools to behave as if they are interacting with real AWS.

The system runs as a single process (typically on port 4566) and routes requests internally to service emulators based on AWS API signatures. Developers can use standard tools like the AWS CLI, Terraform, CDK, Pulumi, or SDKs such as boto3 without modification—only the endpoint needs to be pointed locally.

A key distinction of MiniStack is its hybrid architecture: while many services are emulated in-memory, several core components use real infrastructure under the hood. For example, RDS spins up real Postgres/MySQL Docker containers, ElastiCache runs real Redis instances, and ECS executes real Docker containers via the host runtime.

This design allows developers to test real behavior (databases, queues, containers, execution environments) without relying on cloud resources or paid services. It is particularly aimed at improving local development speed, CI reliability, and infrastructure testing fidelity.

MiniStack is fully compatible with AWS SDKs and infrastructure tools, supporting endpoint overrides for nearly all major AWS services. It also includes a built-in CloudFormation engine, enabling full stack deployment testing locally.

The platform emphasizes zero setup friction: it runs via a single Docker command, requires no account or API keys, and resets cleanly between runs unless persistence is explicitly enabled.

Key features include:

• Local AWS emulator with 45+ services
• Single-port architecture (localhost:4566)
• Real infrastructure support (Postgres, Redis, Docker containers)
• Full AWS SDK compatibility (boto3, AWS CLI, Terraform, CDK, Pulumi)
• CloudFormation engine with stack lifecycle support
• CI/CD-friendly deterministic environments
• Optional persistence for stateful local development
• MIT-licensed and fully open-source
• Drop-in replacement for LocalStack workflows

Common use cases include:

• Local AWS development without cloud costs
• Integration testing for serverless applications
• CI/CD pipelines with isolated cloud environments
• Infrastructure-as-code validation (Terraform/CDK/Pulumi)
• Backend testing with real databases and queues
• Simulating AWS environments for development and QA

MiniStack is developed by a small open-source engineering team focused on simplifying cloud testing and replacing heavyweight cloud emulation stacks with a faster, lighter, and more realistic local-first alternative.