Nitro is no longer supported. Please see our announcement and DDEV migration guide.

Nitro comes with an easy way to setup and configure DynamoDB for local testing.

# Enabling DynamoDB

To enable DynamoDB in Nitro, run the following command:

nitro enable dynamodb

Nitro will then prompt you to apply the changes. After the changes have been applied DynamoDB will be available at https://dynamodb.service.nitro (opens new window).

# Using DynamoDB

To use DynamoDB in your Craft project you can configure your compontent to use the following settings:

Hostname: dynamodb.service.nitro

Port: 8000

The port 8000 will always be the port to use when in a sites container, even if you override the default port using an environment variable.

# Disabling DynamoDB

Removing DynamoDB is as simple as enabling the service. Simply run nitro disable dynamodb and apply the changes. The DynamoDB service will be removed from Nitro and your hosts file.

# Overiding DynamoDB Default Ports

Make sure the DynamoDB service is not enabled before overriding the variables.

By default, DynamoDB uses port 8000 but this port may collide with another service on your machine so Nitro includes an easy way to overide the ports.

You can set the following environment variables in your terminal shell to override the defaults.


Change these ports only affects the ports on the host machine (aka and does not change the internal port used to connect to DynamoDB from a Craft installation/container.