Developer Guide

A guide to the LocalStack system, its code base on how to contribute to the project.

We welcome contributions to LocalStack, under the Contributor LicenseAgreement (CLA).

The guides in this section are for developers of LocalStack, to better understand how LocalStack works internally, how to set up local development environments, and how to contribute to the codebase.


This document contains a few essential instructions for developing new features and bug fixes for LocalStack.

Setup and requirements

Set up your development environment for developing LocalStack.

Integration tests

How to run and write integration tests.

LocalStack Extensions

LocalStack Extensions allows developers to extend and customize LocalStack.

Terraform test suite

How to run the Terraform test suite.

Last modified October 8, 2021: overhaul of developer guide (435e4ca5)