Installing DC/OS on AWS

Installing DC/OS on AWS

You can create a DC/OS cluster for Amazon Web Services (AWS) by using the DC/OS templates on AWS CloudFormation.

These instructions provide a basic AWS CloudFormation template that creates a DC/OS cluster that is suitable for demonstrations and POCs. This is the fastest way to get started with the DC/OS templates for AWS CloudFormation.

For a complete set of DC/OS configuration options, see the Advanced AWS Install Guide.

System requirements


An Amazon EC2 m3.xlarge instance. Selecting smaller-sized VMs is not recommended, and selecting fewer VMs will likely cause certain resource-intensive services, such as distributed datastores, to not work properly.

  • You have the option of 1 or 3 Mesos master nodes.
  • 5 private Mesos agent nodes is the default.
  • 1 public Mesos agent node is the default.


  • An Amazon Web Services account.
  • SSH installed and configured. This is required for accessing nodes in the DC/OS cluster.

Install DC/OS

Depending on the DC/OS services that you install, you might have to modify the DC/OS templates to suit your needs. For more information, see Scaling the DC/OS cluster in AWS.

Prerequisite: You must have an Amazon EC2 Key Pair for the same region as your cluster. Key pairs cannot be shared across regions. The AWS key pair uses public-key cryptography to provide secure login to your AWS cluster. For more information about creating an Amazon EC2 Key Pair, see the documentation.

  1. Launch the DC/OS template on CloudFormation and select the region and number of masters (1 or 3). You must have a key pair for your selected region.

  2. On the Select Template page, accept the defaults and click Next.

    Launch stack

  3. On the Specify Details page, specify a cluster name (Stack name), Key Pair (KeyName), authentication (OAuthEnabled), public agent (PublicSlaveInstanceCount), private agent (SlaveInstanceCount), and click Next.

    Important: The DC/OS template is configured for running DC/OS. If you modify the template you might be unable to run certain packages on your DC/OS cluster.

    Create stack

  4. On the Options page, accept the defaults and click Next.

    Tip: You can choose whether to rollback on failure. By default this option is set to Yes.

  5. On the Review page, check the acknowledgement box and then click Create.

    Tip: If the Create New Stack page is shown, either AWS is still processing your request or you’re looking at a different region. Navigate to the correct region and refresh the page to see your stack.

Monitor the DC/OS cluster convergence process

In CloudFormation you should see:

  • The cluster stack spins up over a period of 10 to 15 minutes.

  • The status changes from CREATE_IN_PROGRESS to CREATE_COMPLETE.

Troubleshooting: A ROLLBACK_COMPLETE status means the deployment has failed. See the Events tab for useful information about failures.

Launch DC/OS

Launch the DC/OS web interface by entering the Mesos Master hostname:

  1. From the Amazon CloudFormation Management page, click to check the box next to your stack.

  2. Click on the Outputs tab and copy/paste the Mesos Master hostname into your browser to open the DC/OS web interface. The interface runs on the standard HTTP port 80, so you do not need to specify a port number after the hostname.

    Tip: You might need to resize your window to see this tab. You can find your DC/OS hostname any time from the Amazon CloudFormation Management page.

    Monitor stack creation

    DC/OS dashboard

  3. Click the dropup menu on the lower-left side to install the DC/OS Command-Line Interface (CLI). You must install the CLI to administer your DC/OS cluster.

    install CLI

Next steps

AWS Advanced

The advanced AWS CloudFormation templates bring power and flexibility to creating and extending DC/OS clusters. With these templates you can choose from the complete set of DC/OS configuration options.

Uninstalling on Amazon Web Services

You can uninstall DC/OS running on AWS EC2 with these instructions.