Deploy Nomad into a new VPC on AWS

To install HashiCorp Nomad on AWS, view the Quick Start deployment guide. You might also want to check out the AWS Quick Starts for HashiCorp Consul and HashiCorp Vault, and view our complete Quick Start catalog.


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. 

The Quick Start includes AWS CloudFormation templates that automate the deployment, and a guide that provides step-by-step instructions for deploying, configuring, and getting started with Nomad on the AWS Cloud.

  • What you'll build

    Use this Quick Start to 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.*
    • 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. 

    * You can choose to create a new VPC or deploy Consul and Nomad into your existing VPC on AWS. The template that deploys the Quick Start into an existing VPC skips the creation of components marked by asterisks and prompts you for your existing configuration.

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

    For details, see the Quick Start deployment guide.

  • Deployment details

    Build your HashiCorp Nomad environment in a few simple steps:

    1. Sign up for an AWS account.
    2. Launch the Quick Start into a new VPC, if you want to build a new AWS infrastructure.
      Launch the Quick Start into an existing VPC, if you already have your AWS environment set up. 
      Each deployment takes about 35 minutes.
    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.  

    For detailed deployment and configuration instructions, see the Quick Start deployment guide.

  • 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. See the pricing pages for each AWS service you will be using for cost estimates.

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