A LocalStack extension to proxy and integrate AWS resources into your local machine. This enables one flavor of "hybrid" or "remocal" setups where you can easily bridge the gap between LocalStack (local resources) and remote AWS (resources in the real cloud).

For a step-by-step tutorial, please refer to the documentation: https://docs.localstack.cloud/aws/tutorials/aws-proxy-localstack-extension/

• LocalStack Pro
• Docker
• Python

Install the extension via the LocalStack CLI:

localstack extensions install localstack-extension-aws-proxy

After installation, restart LocalStack for the extension to take effect.

Enable the proxy for specific services (e.g., DynamoDB, S3, Cognito) by posting a configuration along with your AWS credentials:

curl -X POST http://localhost:4566/_localstack/aws/proxies \
  -H 'Content-Type: application/json' \
  -d '{
    "config": {
      "services": {
        "dynamodb": {},
        "s3": {},
        "cognito-idp": {}
      }
    },
    "env_vars": {
      "AWS_ACCESS_KEY_ID": "<your-access-key-id>",
      "AWS_SECRET_ACCESS_KEY": "<your-secret-access-key>",
      "AWS_SESSION_TOKEN": "<your-session-token>"
    }
  }'

curl http://localhost:4566/_localstack/aws/proxies/status

curl -X POST http://localhost:4566/_localstack/aws/proxies/status \
  -H 'Content-Type: application/json' \
  -d '{"status": "disabled"}'

Once enabled, API calls against LocalStack (e.g., via awslocal) are forwarded to real AWS and return data from your real cloud resources.

The following environment variables can be passed to the LocalStack container to customize behavior:

• PROXY_CLEANUP_CONTAINERS: whether to remove proxy Docker containers on shutdown (default 1). Set to 0 to keep containers for debugging.
• PROXY_LOCALSTACK_HOST: the target host used by the proxy container to connect to LocalStack (auto-detected by default).
• PROXY_DOCKER_FLAGS: additional flags passed when creating proxy Docker containers.

This extension is published under the Apache License, Version 2.0. By using it, you also agree to the LocalStack End-User License Agreement (EULA).