Repository files navigation

⚡ We are thrilled to announce the release ofLocalStack 4.6 ⚡

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

Overview •Install •Quickstart •Run •Usage •Releases •Contributing
📖 Docs •💻 Pro version •☑️ LocalStack coverage

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! ThePro 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'sUser Guides for more information.

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 functionaldocker environment installed before proceeding.

Install the LocalStack CLI through ourofficial LocalStack Brew Tap:

brew install localstack/tap/localstack-cli

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

• Visitlocalstack/localstack-cli and download the latest release for your platform.
• Extract the downloaded archive to a directory included in yourPATH variable:
  • For macOS/Linux, use the command:sudo tar xvzf ~/Downloads/localstack-cli-*-darwin-*-onefile.tar.gz -C /usr/local/bin

LocalStack is developed using Python. To install the LocalStack CLI usingpip, run the following command:

python3 -m pip install localstack

Thelocalstack-cli installation enables you to run the Docker image containing the LocalStack runtime. To interact with the local AWS services, you need to install theawslocal CLI separately. For installation guidelines, refer to theawslocal documentation.

Important: Do not usesudo or run asroot user. LocalStack must be installed and started entirely under a local non-root user. If you have problems with permissions in macOS High Sierra, install withpip install --user localstack

Start LocalStack inside a Docker container by running:

 % localstack start -d     __                     _______ __             __    / /   ____  _________ _/ / ___// /_____ ______/ /__   / /   / __\/ ___/ __`/ /\__\/ __/ __`/ ___/ //_/  / /___/ /_/ / /__/ /_/ / /___/ / /_/ /_/ / /__/ ,< /_____/\____/\___/\__,_/_//____/\__/\__,_/\___/_/|_|- LocalStack CLI: 4.6.0- Profile: default- App: https://app.localstack.cloud[17:00:15] starting LocalStackin Docker mode 🐳               localstack.py:512           preparing environment                               bootstrap.py:1322           configuring container                               bootstrap.py:1330           starting container                                  bootstrap.py:1340[17:00:16] detaching                                           bootstrap.py:1344

You can query the status of respective services on LocalStack by running:

% localstack status services┏━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓┃ Service                  ┃ Status      ┃┡━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩│ acm                      │ ✔ available ││ apigateway               │ ✔ available ││ cloudformation           │ ✔ available ││ cloudwatch               │ ✔ available ││ config                   │ ✔ available ││ dynamodb                 │ ✔ available │...

To use SQS, a fully managed distributed message queuing service, on LocalStack, run:

% awslocal sqs create-queue --queue-name sample-queue{"QueueUrl":"http://sqs.us-east-1.localhost.localstack.cloud:4566/000000000000/sample-queue"}

Learn more aboutLocalStack AWS services and using them with LocalStack'sawslocal CLI.

You can run LocalStack through the following options:

• LocalStack CLI
• Docker
• Docker Compose
• Helm

To start using LocalStack, check out ourdocumentation.

• LocalStack Configuration
• LocalStack in CI
• LocalStack Integrations
• LocalStack Tools
• Understanding LocalStack
• Frequently Asked Questions

To use LocalStack with a graphical user interface, you can use the following UI clients:

• LocalStack Web Application
• LocalStack Desktop
• LocalStack Docker Extension

Please refer toGitHub releases to see the complete list of changes for each release. For extended release notes, please refer to thechangelog.

If you are interested in contributing to LocalStack:

• Start by reading ourcontributing guide.
• Check out ourdevelopment environment setup guide.
• Navigate our codebase andopen issues.

We are thankful for all the contributions and feedback we receive.

Get in touch with the LocalStack Team toreport 🐞issues,upvote 👍feature requests,🙋🏽 asksupport questions,or 🗣️ discuss local cloud development:

• LocalStack Slack Community
• LocalStack GitHub Issue tracker

We are thankful to all the people who have contributed to this project.

We are also grateful to all our backers who have donated to the project. You can become a backer onOpen Collective.

You can also support this project by becoming a sponsor onOpen Collective. Your logo will show up here along with a link to your website.

Copyright (c) 2017-2025 LocalStack maintainers and contributors.

Copyright (c) 2016 Atlassian and others.

This version of LocalStack is released under the Apache License, Version 2.0 (seeLICENSE). By downloading and using this software you agree to theEnd-User License Agreement (EULA).