LocalStack — AWS Cloud Service Emulator for Local Development & CI

What it is

LocalStack is a cloud service emulator that runs inside a single Docker container on your laptop or CI runner. It provides functional implementations of over 80 AWS services including S3, Lambda, DynamoDB, SQS, SNS, IAM, and more. Instead of deploying to AWS for every test, you point your SDK at LocalStack and iterate locally.

This tool is built for backend developers, DevOps engineers, and platform teams who need fast feedback loops without incurring AWS costs or waiting for cloud provisioning.

How it saves time or tokens

LocalStack eliminates the deploy-test-debug cycle against real AWS. A Lambda function that takes 2 minutes to deploy and test on AWS can be tested in seconds locally. CI pipelines run faster because they skip network round-trips to AWS endpoints. Teams also avoid surprise AWS bills from forgotten test resources.

For AI-assisted development, LocalStack lets coding agents test AWS integrations without needing real credentials or permissions, keeping the feedback loop tight.

How to use

1. Install LocalStack via pip or Docker Compose.
2. Start the container with localstack start or docker-compose up.
3. Point your AWS SDK to the LocalStack endpoint (http://localhost:4566).
4. Run your application or tests against the local endpoints.

# Start LocalStack with Docker
docker run --rm -it -p 4566:4566 localstack/localstack

# Create an S3 bucket locally
aws --endpoint-url=http://localhost:4566 s3 mb s3://my-test-bucket

# Put an object
aws --endpoint-url=http://localhost:4566 s3 cp test.txt s3://my-test-bucket/

# List buckets
aws --endpoint-url=http://localhost:4566 s3 ls

Example

A typical docker-compose.yml for LocalStack:

version: '3.8'
services:
  localstack:
    image: localstack/localstack
    ports:
      - '4566:4566'
    environment:
      - SERVICES=s3,lambda,dynamodb,sqs
      - DEBUG=1
    volumes:
      - './localstack:/var/lib/localstack'
      - '/var/run/docker.sock:/var/run/docker.sock'

Then in your Python test:

import boto3

s3 = boto3.client('s3', endpoint_url='http://localhost:4566')
s3.create_bucket(Bucket='test-bucket')
s3.put_object(Bucket='test-bucket', Key='hello.txt', Body=b'Hello')
response = s3.get_object(Bucket='test-bucket', Key='hello.txt')
print(response['Body'].read())  # b'Hello'

Related on TokRepo

• DevOps tools — More infrastructure and deployment tools
• Self-hosted solutions — Other tools you can run locally

Common pitfalls

• Not all AWS API behaviors are perfectly replicated. Some edge cases in IAM policies or advanced Lambda features may differ from production AWS.
• The free Community edition covers most services, but certain enterprise features like EKS and RDS require LocalStack Pro.
• Docker socket mounting is required for Lambda execution with container runtimes. Forgetting this causes silent failures.
• Large-scale load testing against LocalStack does not reflect real AWS latency or throttling behavior.
• Environment variable SERVICES is optional in newer versions. LocalStack now lazily loads services on first request.