AWS Documentation » Amazon DynamoDB » Developer Guide » Setting Up DynamoDB » Setting Up DynamoDB Local (Downloadable Version) » DynamoDB (Downloadable Version) on Your Computer

DynamoDB (Downloadable Version) on Your Computer

The downloadable version of Amazon DynamoDB is provided as an executable .jar file. The application runs on Windows, Linux, macOS X, and other platforms that support Java.

Follow these steps to set up and run DynamoDB on your computer:

1. Download DynamoDB for free using one of the following links.

   Region	Download Links	Checksums
   Asia Pacific (Mumbai) Region	.tar.gz | .zip	.tar.gz.sha256 | .zip.sha256
   Asia Pacific (Singapore) Region	.tar.gz | .zip	.tar.gz.sha256 | .zip.sha256
   Asia Pacific (Tokyo) Region	.tar.gz | .zip	.tar.gz.sha256 | .zip.sha256
   EU (Frankfurt) Region	.tar.gz | .zip	.tar.gz.sha256 | .zip.sha256
   South America (São Paulo) Region	.tar.gz | .zip	.tar.gz.sha256 | .zip.sha256
   US West (Oregon) Region	.tar.gz | .zip	.tar.gz.sha256 | .zip.sha256

   Downloadable DynamoDB is available on Apache Maven. For more information, see DynamoDB (Downloadable Version) and Apache Maven, later in this topic. DynamoDB is also available as part of the AWS Toolkit for Eclipse. For more information, see AWS Toolkit For Eclipse.

   Important

   To run DynamoDB on your computer, you must have the Java Runtime Environment (JRE) version 6.x or newer. The application doesn't run on earlier JRE versions.

2. After you download the archive, extract the contents and copy the extracted directory to a location of your choice.

3. To start DynamoDB on your computer, open a command prompt window, navigate to the directory where you extracted DynamoDBLocal.jar, and enter the following command.

   java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb

   Note

   If you're using Windows PowerShell, be sure to enclose the parameter name or the entire name and value like this:

   java -D"java.library.path=./DynamoDBLocal_lib" -jar DynamoDBLocal.jar

   DynamoDB processes incoming requests until you stop it. To stop DynamoDB, press Ctrl+C at the command prompt.

   DynamoDB uses port 8000 by default. If port 8000 is unavailable, this command throws an exception. For a complete list of DynamoDB runtime options, including -port , enter this command.

   java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help

4. Before you can access DynamoDB programmatically or through the AWS Command Line Interface (AWS CLI), you must configure your credentials to enable authorization for your applications. Downloadable DynamoDB requires any credentials to work, as shown in the following example.

   AWS Access Key ID: "fakeMyKeyId"
   AWS Secret Access Key: "fakeSecretAccessKey"

   You can use the aws configure command of the AWS CLI to set up credentials. For more information, see Using the CLI.

5. You can start writing applications. To access DynamoDB running locally, use the --endpoint-url parameter. For example, use the following command to list DynamoDB tables.

   aws dynamodb list-tables --endpoint-url http://localhost:8000