docker-compose.yml

services:
  localstack:
    container_name: lambda-starter-localstack
    image: localstack/localstack:4.12
    ports:
      - '4566:4566'
    environment:
      # LocalStack configuration
      - SERVICES=s3,dynamodb,sns,lambda,apigateway,logs,iam,sts,cloudformation,ssm
      - DEBUG=${DEBUG:-0}
      - LAMBDA_EXECUTOR=docker
      - DOCKER_HOST=unix:///var/run/docker.sock
      - AWS_DEFAULT_REGION=us-east-1
      # Configure Lambda to access LocalStack from within containers
      - LAMBDA_DOCKER_NETWORK=lambda-starter_lambda-starter-network
      - LOCALSTACK_HOSTNAME=localstack
      # Enable persistence (optional - comment out to disable)
      - PERSISTENCE=${PERSISTENCE:-0}
    volumes:
      # Mount docker socket for Lambda execution
      - /var/run/docker.sock:/var/run/docker.sock
      # Optional: Persist data between restarts
      - ./localstack-data:/var/lib/localstack
    networks:
      - lambda-starter-network

networks:
  lambda-starter-network:
    driver: bridge