MiniStack
lastmod 2026-11-16created 2026-04-024 edits
MiniStack은 AWS API 를 로컬에서 흉내 내는 무료 오픈 소스 에뮬레이터이다. LocalStack 이 핵심 서비스를 유료 플랜으로 옮긴 뒤 LocalStack Community 를 쓰던 로컬 개발·CI 환경의 대안으로 나왔다. 포트 4566 하나로 60개 넘는 서비스를 받고, 계정 가입이나 API 키 없이 바로 띄운다.
About
- boto3, AWS CLI, Terraform, CDK, Pulumi 등 기존 SDK·도구를 엔드포인트만 바꿔 그대로 씀
- 일부 서비스는 실제 인프라를 띄움. RDS 는 Postgres/MySQL 컨테이너, ElastiCache 는 Redis/Valkey, ECS 는 Docker 컨테이너, Athena 는 DuckDB 로 SQL 을 실행함(full 이미지)
- 12자리 액세스 키가 곧 계정 ID 가 되고 SigV4 리전으로 상태를 나눠, 한 엔드포인트에서 여러 계정·리전을 격리함
- Bedrock 의 Converse·InvokeModel 을 흉내 내며,
MINISTACK_BEDROCK_PROXY_URL로 Ollama·llama.cpp·vLLM 에 연결하면 실제 응답을 받음 -
/_ministack/reset으로 모든 상태를 비우고, SES·SQS·SNS 로 보낸 메시지를 내부 API 로 조회할 수 있어 테스트 사이 초기화에 씀 - 시작 2초 이내, 유휴 메모리 약 30MB. LocalStack(이미지 약 1GB, 메모리 약 500MB)과 비교해 제시함
-
pip install ministack또는 Docker 이미지ministackorg/ministack로 실행. Python 3.10 이상, MIT 라이선스
See also
- AWS
- Floci - 무료 오픈소스 로컬 AWS 에뮬레이터
- moto - Mock AWS Services
- LocalStack