README

[!IMPORTANT]
 Project Update: Consolidation into the Unified LocalStack Image

 To provide a more reliable and streamlined experience, we are consolidating our development into a single, unified image. As part of this transition, this repository is now archived and read-only.

 This decision reflects our commitment to reducing fragmentation and focusing our resources on building the most robust AWS emulation layer possible. We are deeply grateful to the contributors who helped make this project into what it is today–your work remains integral to the future of the LocalStack ecosystem.

 What this means for your workflow:

 - LocalStack for AWS offers a range of options including a free Hobby plan for non-commercial use with the same capabilities as this project.
 - Your input is still vital to us. Please continue to share bug reports here and submit feature requests here or join our Slack Community.

 Thank you for your continued support as we grow together.


  



  
  
  
  
  
  
  
  
  



  LocalStack is a cloud software development framework to develop and test your AWS applications locally.



  Overview •
  Install •
  Quickstart •
  Run •
  Usage •
  Releases •
  Contributing
  
  📖 Docs •
  💻 LocalStack for AWS •
  ☑️ LocalStack coverage


---

 Overview

LocalStack is a cloud service emulator that runs in a single container on your laptop or in your CI environment. With LocalStack, you can run your AWS applications or Lambdas entirely on your local machine without connecting to a remote cloud provider! Whether you are testing complex CDK applications or Terraform configurations, or just beginning to learn about AWS services, LocalStack helps speed up and simplify your testing and development workflow.

LocalStack supports a growing number of AWS services, like AWS Lambda, S3, DynamoDB, Kinesis, SQS, SNS, and many more! The Pro version of LocalStack supports additional APIs and advanced features. You can find a comprehensive list of supported APIs on our ☑️ Feature Coverage page.

LocalStack also provides additional features to make your life as a cloud developer easier! Check out LocalStack's User Guides for more information.

 Install

The quickest way to get started with LocalStack is by using the LocalStack CLI. It enables you to start and manage the LocalStack Docker container directly through your command line. Ensure that your machine has a functional docker environment installed before proceeding.

 Brew (macOS or Linux with Homebrew)

Install the LocalStack CLI through our official LocalStack Brew Tap:

bash
brew install localstack/tap/localstack-cli


 Binary download (macOS, Linux, Windows)

If Brew is not installed on your machine, you can download the pre-built LocalStack CLI binary directly:

- Visit localstack/localstack-cli and download the latest release for your platform.
- Extract the downloaded archive to a directory included in your PATH variable:
  - For macOS/Linux, use the command: sudo tar xvzf ~/Downloads/loc

Latest release

Summary

LocalStack for AWS 4.14 introduces a new Resource Groups Tagging API provider with native integrations across EC2, KMS, S3, Lambda, Route 53, SNS, SQS, OpenSearch, and Elastic Beanstalk. This release adds KRaft cluster support for Amazon MSK, switches Hive to use Glue as its default metastore, and integrates EKS nodes with the Instance Metadata Service (IMDS). Additional improvements include CloudFormation DeletionPolicy and UpdateReplacePolicy support, Step Functions testing enhancements, and parity updates across S3, Route 53, ECS, ElastiCache, and RDS.

 AWS Features

 LocalS