Account Setup

This page covers making sure your AWS account is compatible with and correctly configured for Datomic Cloud:

Subscribe to Datomic

Follow these steps from the Datomic listing on AWS Marketplace:

  1. If the top right button says Continue to Configuration, you are already subscribed, and can skip the remaining steps. If the button says Continue to Subscribe, click it.


  2. On the next page, read the EULA and if you agree then click the Accept Terms button to subscribe.


  3. Wait up to 30 minutes until your subscription is confirmed with a message in the green status bar:


EC2 Key Pair

You need an EC2 Key Pair to associate with EC2 instances launched by Datomic Cloud. This keypair is never used as part of normal operation, but is available in case an operator wants to e.g. open SSH ingress and log into boxes.

If you do not already have an EC2 Key Pair, create one from the EC2 Key Pair console

  1. Click the Create Key Pair button.
  2. Enter a name for your new Key Pair. Take note of this name–You will need it when you start a system.
  3. Press the Create button.
  4. Save the downloaded certificate (.pem) file for later use.
  5. From a terminal window run:

    chmod 400 <path-to-your-pem-file>

    Replacing <path-to-your-pem-file> with the path to the .pem file you downloaded in step 4.

Verify Region is EC2-VPC Only

Datomic Cloud requires an AWS account that supports only EC2-VPC. This includes all accounts created after Dec 4, 2013. If you have an older account, verify that you have an EC2-VPC only region, follow these instructions in one of the supported regions.

  1. Open the Amazon EC2 console
  2. Use the navigation bar in the upper right to choose the region in which you will run Datomic.
  3. On the Amazon EC2 console dashboard, look for Supported Platforms under Account Attributes. If you see only "VPC", your region is EC2-VPC only, and you can run Datomic in this region.


    If you see "EC2" listed under Supported Platforms (even if you also see "VPC"), then this region is EC2-Classic, and you cannot run Datomic in this region at this time.


    If the region you checked is an EC2-Classic region, one of your other regions might still be an EC2-VPC only region, if you didn't use that region prior to Dec 4, 2013. Follow the above instructions to check in the other supported regions.

If you don't have any EC2-VPC only regions, you must create a new account to run Datomic Cloud at this time. You can associate it with your existing account(s) using AWS Consolidated Billing for Organizations .

To use consolidated billing, you must either have or create an Organization . You may then either associate existing accounts with it or create a new one

Raise the i3.large Instance Limit

The Production Topology requires two or more i3.large EC2 instances. Some AWS accounts have a default limit equivalent to one i3.large instance. To check your account instance limit

  • click on

Limits in the EC2 Dashboard Menu:

  • Scroll down to find the Running On-Demand All... which includes i instances in the instance list.
  • Open the

Limits Calculator

  • Add a number of i3.large instance types that is 2+ and corresponds to how high you plan to scale your system.
  • Ensure that your Current limit is greater than the vCPUs needed. Ignore the "New limit" value, as this is assumes that you are currently at your vCPU limit.
    • If your Current limit exceeds the number of vCPUs needed then click the Request on-deman limit increase link under "Options".
    • Request the number of vCPUs that match your planned system needs.

Once complete, submit the form and you will receive confirmation from AWS once your instance limit has been raised.

Supported Regions

Datomic Cloud currently runs in the following AWS regions:

  • us-east-1
  • us-east-2
  • us-west-2
  • eu-central-1
  • ap-southeast-1
  • ap-southeast-2
  • ap-southeast-2
  • ap-northeast-1
  • ap-south-1
  • sa-east-1
  • eu-west-1
  • eu-west-2
  • eu-north-1

If you are unfamiliar with AWS region codes, you can review available AWS region codes here.

If you are interested in a region not shown here, please contact Datomic Support.