> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/5/configure-dynamodb-table/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Configure Amazon DynamoDB shared database

Itential Gateway supports Amazon DynamoDB as a database storage option. You need a DynamoDB or etcd database if you plan to run Gateway in a distributed execution cluster or with highly available controller nodes.

* For information on setting up, running, and using DynamoDB tables, visit the [Amazon DynamoDB documentation](https://docs.aws.amazon.com/dynamodb/).
* For more information on distributed execution clusters and high availability clusters, see [Choose a deployment architecture](/itential-gateway/5/choose-deployment-architecture).
* For more information on `GATEWAY_STORE_DYNAMODB_TABLE_*` variables, see [Store variables](/itential-gateway/5/gateway-store-variables).

## Configure DynamoDB table for Gateway

#### Set Gateway configuration variables

To connect your Gateway deployment to DynamoDB, set the following configuration variables:

* `GATEWAY_STORE_BACKEND=dynamodb`
* (Optional) `GATEWAY_STORE_DYNAMODB_TABLE_NAME=<table-name>`

If you do not specify a table name, Gateway uses the default value `itential.gateway5.store`.

For more information on changing gateway settings, see [Configuration variables](/itential-gateway/5/configuration-variables-overview).

#### Create your DynamoDB table

Next, create the DynamoDB table that Gateway will connect to. The following procedures demonstrate how to create a DynamoDB table using the AWS Management Console. For more information on creating tables, see [Create a table](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/getting-started-step-1.html) in the *Amazon DynamoDB Developer Guide*.

1. Sign into the AWS Management Console and open the DynamoDB console.
2. In the left navigation pane, choose **Tables**.
3. Choose **Create table**.
4. Enter the **Table details** as follows:
   * For **Table name**, enter the table name you specified for `GATEWAY_STORE_DYNAMODB_TABLE_NAME` in Step 1. If you did not specify a table name, enter the default table name `itential.gateway5.store`.
   * For **Partition key**, enter `namespace`.
   * For **Sort key**, enter `key`.
5. For **Table settings**, specify your optimization and billing preferences. To get started, you can keep the default selection **Default settings**.
6. (Optional) Enter any tags that align with your standard AWS deployment strategy.
7. Choose **Create table** to create the table.

#### Configure AWS variables

Next, configure your AWS region and credentials. Gateway uses the default region and credential loaders that AWS provides. This means that Gateway reads this information using standard methods for AWS-connected applications.

For more information on specifying the AWS Region and your Credentials, see the “Configure the SDK” topic in the AWS SDK documentation of your choice. For example, [Configure the SDK](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/configure-gosdk.html) in the *AWS SDK for Go v2 Developer Guide* demonstrates how to configure regions and specify credentials using environment variables.

Use the `AWS_REGION` environment variable to explicitly set the AWS region on your Gateway instance.