• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Nomad
  • Install
  • Intro
  • Tutorials
  • Documentation
  • API
  • Tools
  • Plugins
  • Sign up
Nomad Home

Documentation

Skip to main content
  • Documentation
    • Overview
    • Quickstart
    • Windows Service


  • Schedulers

  • Nomad Ecosystem
  • Nomad Partnerships
  • Who Uses Nomad
  • FAQ

  • Resources

  • Tutorial Library
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  1. Developer
  2. Nomad
  3. Documentation
  4. Installing Nomad
  5. Quickstart
  • Nomad
  • v1.3.x
  • v1.2.x
  • v1.1.x
  • v1.0.x
  • v0.12.x
  • v0.11.x

ยปQuickstart

This page lists multiple methods to installing Nomad locally or in a sandbox environment.

These installations are designed to get you started with Nomad easily and should be used only for experimentation purposes. If you are looking to install Nomad in production, please refer to the Production Installation guide here.

Experiment with Nomad in your browser via guides containing embedded interactive learning environments.

  • Interactive Labs

Install Nomad on the public cloud.

  • AWS

    • CloudFormation

    • Terraform

  • Azure

    • Terraform

Install Nomad on your machine

If you would like to try Nomad locally, you can install Nomad on your local machine using the same steps that you would for a production environments and run a single-node development instance using the nomad agent -dev command

Installing Nomad

Note: If you are using Docker Desktop for Windows or MacOS, please check our FAQ.

Run Nomad in Vagrant

Alternatively, you can use a Vagrant to set up a development environment for Nomad. Vagrant is a tool for building and managing virtual machine environments.

Note: To use the Vagrant environment, first install Vagrant following these instructions. You will also need a virtualization tool, such as VirtualBox.

You can download a Vagrantfile which can start a small Nomad cluster. First create a new directory for your Vagrant environment.

$ mkdir nomad-vagrant

Change into the directory you made with the previous command.

$ cd nomad-vagrant

Now you can get the Nomad installation configuration.

$ curl -O https://raw.githubusercontent.com/hashicorp/nomad/master/demo/vagrant/Vagrantfile

Now that you have created a new directory and downloaded the Vagrantfile you must create the virtual machine with the vagrant up command.

$ vagrant up

This takes a few minutes as the base Ubuntu box must be downloaded and provisioned with both Docker and Nomad. Once this completes, you should see this output.

Bringing machine 'default' up with 'virtualbox' provider...
==> default: Importing base box 'bento/ubuntu-18.04'...
...
==> default: Running provisioner: docker...

At this point the Vagrant box is running and ready to go.

Edit this page on GitHub
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)