LocalStack Connection

LocalStack is a cloud service emulator that runs in a Docker container and provides a local testing environment for AWS applications. Dynomate supports connecting to LocalStack's DynamoDB implementation, allowing you to develop and test applications without incurring AWS costs or requiring internet connectivity.

LocalStack Support Only

Currently, Dynomate supports LocalStack for local development, but does not directly support the standalone DynamoDB Local downloadable version. This allows you to work with a consistent local environment that emulates AWS services.

Local Development Benefits

Using Dynomate with LocalStack's DynamoDB implementation offers several benefits:

Work completely offline without an internet connection
Develop and test against a local database without incurring AWS costs
Experiment with table designs and data models safely
Use the same Dynomate interface for both local and cloud-based DynamoDB operations

Consistency with Cloud Experience

Dynomate provides the same interface and workflow for both LocalStack and AWS cloud-based DynamoDB instances, meaning you can develop locally with a familiar experience and then seamlessly transition to working with production data when needed.

Connecting to LocalStack

To connect Dynomate to a LocalStack database, you need to configure an AWS profile with the endpoint_url property pointing to your LocalStack instance:

[profile local-v2]
region = us-east-1
aws_access_key_id = fake
aws_secret_access_key = fake
endpoint_url = http://localhost:8005

Add this configuration to your AWS config file (typically located at ~/.aws/config on macOS/Linux or %USERPROFILE%\.aws\config on Windows). The endpoint_url should match the host and port where your LocalStack instance is running.

Starting LocalStack

You can start LocalStack using Docker:

docker run -p 4566:4566 localstack/localstack

This will run LocalStack with its default configuration, making DynamoDB available at http://localhost:4566 alongside other AWS service emulations.