reference deployment

HashiCorp Nomad on AWS

Cluster manager and deployment scheduler on the AWS Cloud

This Quick Start deploys HashiCorp Nomad automatically into a flexible, scalable, configurable environment in your AWS account in about 35 minutes.

Nomad is a distributed, highly available, data center-aware cluster manager and scheduler that helps deploy applications on any infrastructure, at any scale, on premises or in the cloud. It supports virtualized, containerized, or standalone applications running on all major operating systems, and handles a broad range of workloads.

To see Quick Starts for other HashiCorp products, view our complete catalog.


This Quick Start was developed by HashiCorp, Inc. in collaboration with AWS. HashiCorp is an
APN Partner.

  •  What you'll build
  •  How to deploy
  •  Cost and licenses
  •  What you'll build
  • Use this Quick Start to automatically set up the following HashiCorp Nomad environment, which also includes HashiCorp Consul, on AWS:

    • A virtual private cloud (VPC) configured with public and private subnets across three Availability Zones. This provides the network infrastructure for your HashiCorp Nomad deployment.*
    • An internet gateway to provide access to the internet. The bastion hosts use this gateway to send and receive traffic.*
    • In the public subnets, NAT gateways to provide outbound Internet connectivity for your HashiCorp Consul and Nomad instances.*
    • In the public subnets, Linux bastion hosts to allow inbound Secure Shell (SSH) access to your HashiCorp Consul and Nomad instances.*
    • An AWS Identity and Access Management (IAM) instance role with fine-grained permissions for access to AWS services necessary for the deployment process.
    • Security groups to enable communication within the VPC and to restrict access to only necessary protocols and ports.
    • In the private subnets, a user-configurable number of HashiCorp Consul server and client instances within separate Auto Scaling groups. If the number of client nodes is set to 0 (which is the default), the Quick Start won’t create the Consul client Auto Scaling group, and Consul client instances will be co-located on Nomad client and server instances instead.
    • In the private subnets, a user-configurable number of HashiCorp Nomad client and server instances within separate Auto Scaling groups.  

    *  The template that deploys the Quick Start into an existing VPC skips the tasks marked by asterisks and prompts you for your existing VPC configuration.

    To build this architecture on AWS, the Quick Start implements a modular structure that uses and extends three other Quick Start reference deployments:

  •  How to deploy
  • To build your HashiCorp Nomad environment on AWS, follow the instructions in the deployment guide. The deployment process includes these steps:

    1. If you don't already have an AWS account, sign up at
    2. Launch the Quick Start. Each deployment takes about 35 minutes. You can choose from two options:
    3. Use an SSH agent to access Nomad, and verify the deployment.
    4. Use the sample file provided with the Quick Start to get started using Nomad.

    To customize your deployment, you can choose different instance types for your resources, and set the number of Nomad and Consul server and client nodes.

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on the Quick Start.  

  •  Cost and licenses
  • You are responsible for the cost of the AWS services used while running this Quick Start reference deployment. There is no additional cost for using the Quick Start.

    The AWS CloudFormation template for this Quick Start includes configuration parameters that you can customize. Some of these settings, such as instance type, will affect the cost of deployment. For cost estimates, see the pricing pages for each AWS service you will be using. Prices are subject to change.

    This Quick Start uses the open-source version of HashiCorp Nomad, which doesn’t require a license.