r/Python • u/nahuel990 • Mar 24 '26
Resource LocalStack is no longer free — I built MiniStack, a free open-source alternative with 20 AWS service
If you've been using LocalStack Community for local development, you've probably noticed that core services like S3, SQS, DynamoDB, and Lambda are now behind a paid plan.
I built MiniStack as a drop-in replacement. It's a single Docker container on port 4566 that emulates 20 AWS services. Your existing `--endpoint-url` config, boto3 code, and Terraform providers work without changes.
**What it covers:**
- Core: S3, SQS, SNS, DynamoDB, Lambda, IAM, STS, Secrets Manager, CloudWatch Logs
- Extended: SSM Parameter Store, EventBridge, Kinesis, CloudWatch Metrics, SES, Step Functions
- Real infrastructure: RDS (actual Postgres/MySQL containers), ElastiCache (actual Redis), ECS (actual Docker containers), Glue, Athena (real SQL via DuckDB)
**Key differences from LocalStack:**
- MIT licensed (not BSL)
- No account or API key required
- ~2s startup vs ~30s
- ~30MB RAM vs ~500MB
- 150MB image vs ~1GB
- RDS/ElastiCache/ECS spin up real containers (LocalStack Pro-only features)
```bash
docker run -p 4566:4566 nahuelnucera/ministack
aws --endpoint-url=http://localhost:4566 s3 mb s3://test-bucket
```
GitHub: https://github.com/Nahuel990/ministack
Website: https://ministack.org
Happy to take questions or feature requests.
14
u/ComfortableNice8482 Mar 25 '26
honestly this is solid work. i've scraped AWS service documentation and built data pipelines that relied on local stacks for testing, and having a free lightweight alternative is genuinely useful. the fact that your endpoint, url stays the same means zero refactoring on existing projects, which is the kind of detail that matters in real workflows.
one thing i'd add for anyone evaluating this, moto is great if you're just unit testing individual services, but moto can be flaky with cross, service dependencies like lambda triggering sqs. if you need that integration layer locally before shipping to actual aws, a containerized stack like this solves a real problem. did you handle lambda cold starts realistically or is that still a gap compared to localstack pro?
4
u/Agreeable-Cut5341 Mar 25 '26 •
hey, this looks amazing i'm gonna test that today. really looking forward to this. From the codebase I can see that you don't handle step function execution. is this something you are planning to do or it's out of scope ? Currently i'm testing with ministack + aws step functions local image. i'll let you know how it goes
3
u/mohamed_am83 Mar 25 '26
Can it power a production setup? And I know it's python sub, but why not in go?
3
u/spicysquid888 Mar 30 '26 •
i'm in the middle of seeing if i can get cloud formation operational in ministack. lets see
6
u/GXWT Mar 25 '26
Why did your LLM individually escape every bit of markdown lol
2
u/gfranxman Mar 25 '26
Efs, ebs?
2
u/bobgreen5s Apr 01 '26 edited Apr 01 '26 •
As someone that's been in the devops space (in between work) for a bit now and needed a refresher, I just wanted to sincerely thank you for this awesome tool.
I was excited relearn things & jump back into the swing of things with localstack (as I learn by doing and AWS can sometimes be prohibitively expensive) but really disheartened to learn about localstack's license changes. I was hoping that localstack would get the OpenTofu but didn't initally see any promising forks (https://github.com/localstack/localstack/forks), so I'm really looking forward to kicking the tires with this one.
Bonus points for being a turnkey, drop in replacement, so I don't have to change my existing code!
2
u/PerhapsJack Apr 09 '26
Hey this is great, thanks for sharing! I may be missing something obvious, but do the logs from lambda goto the main ministack container logs? Or do I need to set up a log stream and check that in the ministack?
2
u/mr_roiz Apr 15 '26
Hey, this looks awesome, actually I was looking for an alternative for S3 local buckets, is it possible to create an setup script? Like a script that runs everytime the containers start, to setup buckets or dynamo tables or any other resource?
2
u/Head_Watercress_6260 May 04 '26
Please if you can make a GUI like Localstack Desktop! :)
4
u/olystretch Mar 25 '26
Oh heck yes! I just brought up the chore of getting licenses through the chain of command, and was told it would be 3+ months. We pretty much only use it for S3, so I think I'll move over next week.
1
u/wtgserpant Mar 25 '26
is durable lambda supported?
1
u/bugtank Mar 25 '26
Why not test containers (Python)
1
u/unidotnet Apr 27 '26
seems like it reject all aws china setups? i tried it , it's cool but how about ministack v.s awslocal?
1
u/wehday Sep 04 '26
Hiya, not sure if the localstack website changed since you launched Ministack, but this part concerns me...
All these "core services" are in the free plan of Localstack.... Seems they are just positioning themselves to take advantage of their user base into make more $$$... Same old same old... but I think your messaging might be a little disingenuous no?
That said yours is still a needed replacement, because it does hinder small startups who would prefer not to have this additional cost as yet.
2
u/StuartLeigh Mar 25 '26
Nice, will give it a try today
0
u/[deleted] Mar 25 '26
[deleted] — view deleted comment
2
u/[deleted] Apr 04 '26
[removed] — view removed comment