Starting Up

To start the LocalStack platform in your local Docker environment:

SERVICES=... localstack start

The environment variable SERVICES is a comma-separated list of services (see available services here). We recommend limiting the list of services to start up (e.g., SERVICES=lambda,s3,cognito,rds), to keep a low memory footprint and optimize performance.

Please note: Starting with version 0.11.0, all services are exposed via a single edge service endpoint - http://localhost:4566 by default. (The old service-specific port numbers from previous releases are now deprecated and disabled.)

Running In Docker Compose

Alternatively, you can also spin up LocalStack using Docker Compose. Below is a sample docker-compose.yml configuration file that can be used as a starting point (please make sure to fill in LOCALSTACK_API_KEY, and that the port ranges correspond to the services you’re starting):

version: '2.1'
    image: localstack/localstack
      - ""
      - ""
      - ""
      - ""
      - SERVICES=serverless,cognito,rds
      - DEBUG=1
      - DATA_DIR=/tmp/localstack/data
      - DOCKER_HOST=unix:///var/run/docker.sock
      - "${TMPDIR:-/tmp/localstack}:/tmp/localstack"
      - "/var/run/docker.sock:/var/run/docker.sock"

Note: Please make sure to mount a persistent temporary folder /tmp/localstack into the container, as this is required to enable API key caching, allowing you to work offline (see this section for more details).