Start a System

There are two ways to start a Datomic System:

  • This page describes starting a single master stack using the AWS Marketplace template, and is recommended for first-time users.
  • Experienced users should skip this page, and instead follow the split stack instructions.


The following three tasks start a Datomic system. These tasks need only be performed once, by an AWS administrator.


Before you can start a system, you must have:

Create Stack

Follow these steps from the Datomic listing on AWS Marketplace:

  1. If the top right button says Continue to Subscribe, you do not have a subscription yet. Go back and complete the prerequisites.
  2. Click the Continue to Configuration Button in the top right.
  3. Choose a Fulfillment Option. First-time users should choose the "Solo" topology.
  4. Choose the most recent version and an AWS Region from the drop down menus.
  5. Click the Continue to Launch button.
  6. Select "Launch CloudFormation" from the the drop down menu and click the Launch button.

"Select Template" Screen

  1. Under "Choose a Template", select the "Specify an Amazon S3 template URL" option. The URL field will be pre-populated for you.
  2. Click the Next button

"Specify Details" Screen

Fill in the template's parameter values as specified below.

Stack Name
Choose a good name for your system. Use only lowercase letters, numbers, and hyphens. ASCII characters only. Your system name gets concatenated in various contexts and so should be kept short, e.g. fewer than 24 characters.
Reuse existing storage
Set this to "False".
Start access gateway?
Set this to "Yes" so that the template will start an access gateway.
AWS EC2 Key Pair
The key pair to assign to compute nodes. Select a key pair for ssh access to nodes and the access gateway.
Application Name
Leave this blank to create an application with the same name as the system.
Environment Map
Ion environment map. Set to {:env :dev} for now.
Preload Database
All compute group instances will load this database when they start.

This CloudFormation Template creates a VPC in which to run Datomic Cloud. Configure the settings for the VPC in the VPC Configuration section. See the AWS VPC Guide for details on specifying the CIDR blocks. Unless you know you need to change the CIDR block settings, you should accept the default configuration.

VPC CIDR block
The CIDR block to assign to the VPC. Accept the defaults.
First, Second, and Third CIDR Blocks.
Datomic will configure three subnets in the VPC. These three CIDR Blocks must be subsets of the VPC CIDR Block, and they must not overlap with each other. Accept the defaults.
Existing IAM managed policy for node
Optional. The ARN of an IAM managed policy to add to the role that group nodes run with. Leave blank.

Click the Next button.

"Options" Screen

  1. Leave the default settings
  2. Click the Next button.

"Review" Screen

  1. Under "Capabilities", click the checkbox stating "I acknowledge that AWS CloudFormation might create IAM resources with custom names." You may need to scroll down.


  2. Click the checkbox stating "I acknowledge that AWS CloudFormation might require the following capability: CAPABILITY_AUTO_EXPAND"
  3. Click "Create" to launch the stack.

Verify System

Your Datomic system will have a Cloudwatch dashboard named datomic-\((System)-\)(Region). Open the CloudWatch dashboards and refresh the window until your dashboard appears. This can take several minutes.

If your dashboard does not appear after 25 minutes, check for a possible CloudFormation failure.

Once your dashboard is visible, click on it and find the "Alerts, Events" widget. If this shows zero Alerts and nonzero Events, your system is ready to go.

Next: Configure User Access.