Local development

Dynomate supports connecting to local DynamoDB instances through DynamoDB Local or LocalStack. Both work by configuring an AWS profile with a custom endpoint_url.

To start DynamoDB Local, see Running DynamoDB Local with Docker.

Connecting to DynamoDB Local

Create an AWS profile with the endpoint_url pointing to your DynamoDB Local instance:

[profile dynamodb-local]region = us-east-1aws_access_key_id = fakeaws_secret_access_key = fakeendpoint_url = http://localhost:8000

Add this to your AWS config file (typically ~/.aws/config on macOS/Linux or %USERPROFILE%\.aws\config on Windows), then select the profile in Dynomate.

Start DynamoDB Local with -sharedDb. Without it, DynamoDB Local keeps separate data for each access key and Region, so Dynomate might not see tables that other tools created.

Connecting to LocalStack

Same approach — create an AWS profile pointing to your LocalStack endpoint:

[profile localstack]region = us-east-1aws_access_key_id = fakeaws_secret_access_key = fakeendpoint_url = http://localhost:4566

Select the profile in Dynomate and you're connected.

If Dynomate cannot connect, see DynamoDB Local and LocalStack troubleshooting.

Next steps

• Set an endpoint in a request.
• Create and fill a local table with a request.
• Test requests against DynamoDB Local in CI.