Deploy AWS LocalStack using Docker Composer


LocalStack is an open source tool that lets you simulate AWS (Amazon Web Services) cloud services, on your own computer. It creates a self contained and user environment for developers to experiment with and build AWS applications without worrying about any real costs from AWS usage. The main goal of LocalStack is to mirror the functionality of AWS services giving you the flexibility to develop and test your applications offline or, in a development setting.

Step 1: Creating Docker Compose File

Create a docker-compose.yml file to define the LocalStack service and its dependencies. Here’s an example docker-compose.yml file:

version: '3'
    image: localstack/localstack
      - "4563-4599:4563-4599"
      - "8055:8080"
      - SERVICES=s3,lambda,cloudwatch,iam,apigateway
      - DEBUG=1
      - DATA_DIR=/tmp/localstack/data
      - LAMBDA_EXECUTOR=docker
      - "${TMPDIR:-/tmp/localstack}:/tmp/localstack"

This example sets up LocalStack to emulate several AWS services (S3, Lambda, CloudWatch, IAM, and API Gateway) and maps their respective ports.

Step 2: Deployment of AWS LocalStack

Start LocalStack Container: Open a terminal and navigate to the directory containing your docker-compose.yml file. Run the following command to start the LocalStack container:

sudo docker compose up -d

This will download the LocalStack image if you don’t already have it and start the services you specified.

Step 3: Verify the LocalStack Container

To validate the localstack container, We can execute the given command.

sudo docker ps 

Step 4: Clean-up

To stop and remove the LocalStack container when you’re done, press Ctrl+C in the terminal where you started the container, and then run the following command to remove the stopped container:

docker-compose down


That’s it! You now have a LocalStack instance running in a Docker container, emulating AWS services locally for development and testing purposes. You can customize the docker-compose.yml file to add or remove services and configure specific settings as needed.


Deploy AWS LocalStack using Docker Composer

Leave a Reply

Your email address will not be published. Required fields are marked *

Scroll to top