About this project

MiniStack is a free, open-source local AWS emulator designed as a drop-in replacement for LocalStack Community, which moved core services behind a paid plan. It emulates 60+ AWS services on a single port (4566) and is compatible with boto3, AWS CLI, Terraform, CDK, Pulumi, and any AWS SDK. Key features include: - **Multi-account & multi-region**: A 12-digit access key becomes the account ID, and the SigV4 region scopes state, providing isolated tenants and regions on one endpoint. - **Real infrastructure**: RDS spins up actual Postgres/MySQL containers, ElastiCache runs real Redis/Valkey, Athena runs real SQL via DuckDB (full image only), and ECS runs real Docker containers. - **Amazon Bedrock locally**: Converse/InvokeModel with AWS-exact wire shapes; point MINISTACK_BEDROCK_PROXY_URL at Ollama, llama.cpp, or vLLM for real completions. - **Tiny footprint**: ~270MB image, ~30MB RAM at idle vs LocalStack's ~1GB image and ~500MB RAM. - **Fast startup**: Under 2 seconds, HTTP/2 (h2c) supported. - **MIT licensed**: Free to use, fork, and contribute. Quick start options include pip install, Docker Hub, or building from source. Internal endpoints provide health checks, state reset, runtime config, and inspection of SES/SQS messages. Multi-tenancy and multi-region isolation are automatic with no configuration. The project is actively developed with a changelog and CI pipeline.