Skip to main content

LocalStack - A fully functional local Cloud stack

Project description

:zap: We are thrilled to announce LocalStack 2.0 which brings new features, enhancements and bugfixes :zap:

LocalStack - A fully functional local cloud stack

CircleCI Coverage Status PyPI Version Docker Pulls PyPi downloads Backers on Open Collective Sponsors on Open Collective PyPI License Code style: black Twitter

LocalStack provides an easy-to-use test/mocking framework for developing cloud applications.

📖 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! 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 Cloud Developer Tools for more information.


  • python (Python 3.7 up to 3.11 supported)
  • pip (Python package manager)
  • Docker


The easiest way to install LocalStack is via pip:

pip install localstack

This installs the localstack-cli which is used to run the Docker image that hosts the LocalStack runtime.

Important: Do not use sudo or run as root 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 with pip install --user localstack


Start LocalStack inside a Docker container by running:

 % localstack start -d

     __                     _______ __             __
    / /   ____  _________ _/ / ___// /_____ ______/ /__
   / /   / __ \/ ___/ __ `/ /\__ \/ __/ __ `/ ___/ //_/
  / /___/ /_/ / /__/ /_/ / /___/ / /_/ /_/ / /__/ ,<

 💻 LocalStack CLI 2.0.0

[20:22:20] starting LocalStack in Docker mode 🐳
[20:22:21] detaching

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://localhost:4566/000000000000/sample-queue"

Learn more about LocalStack AWS services and using them with LocalStack's awslocal CLI.


You can run LocalStack through the following options:


To start using LocalStack, check out our documentation at

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


Please refer to GitHub releases to see the complete list of changes for each release. For extended release notes, please refer to the LocalStack Discuss.


If you are interested in contributing to LocalStack:

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

Get in touch

To get in touch with LocalStack team for bugs/feature requests, support questions or general discussions, please use:


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 on Open Collective.


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


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

Copyright (c) 2016 Atlassian and others.

This version of LocalStack is released under the Apache License, Version 2.0 (see LICENSE). By downloading and using this software you agree to the End-User License Agreement (EULA). To know about the external software we use, look at our third party software tools page.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

localstack-2.1.0.tar.gz (4.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page