Nomad is available as a pre-compiled binary or as a package for several operating systems. You can also build Nomad from source.
If you are interested in trialing Nomad without installing it locally, see the Quickstart for options to get started with Nomad.
You can download a precompiled binary and
run it on your machine locally. You can also verify the binary using the
available SHA-256 sums. After downloading Nomad, unzip the package. Make sure
nomad binary is available on your
PATH before continuing with the
You can check the locations available on your path by running this command.
$ echo $PATH /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
The output is a list of locations separated by colons. You can make Nomad
available by moving the binary to one of the listed locations, or by adding
Nomad's location to your
Tip (Linux-based or Mac): Permanently add a new location to your path by
editing your shell's settings file (usually called something like
where the part of the file name after the
. and before
rc is the name of
your shell). In that file you will see a line that starts with
followed by a colon-separated list of locations. Add the location of the Nomad
binary to that list and save the file. Then reload your shell's configuration
with the command
source ~/.bashrc, replacing
bash with the name of your
Tip (Windows): Add a location to your path via the GUI by navigating to
Environment Variables in your system settings, and looking for the variable
PATH. You will see a semicolon-separated list of locations. Add the
Nomad binary's location to that list and then launch a new console window.
»Verify the Installation
To verify Nomad was installed correctly, try the
You should see help output, similar to the following.
Usage: nomad [-version] [-help] [-autocomplete-(un)install] <command> [args] Common commands: run Run a new job or update an existing job stop Stop a running job status Display the status output for a resource alloc Interact with allocations job Interact with jobs node Interact with nodes agent Runs a Nomad agent Other commands: acl Interact with ACL policies and tokens agent-info Display status information about the local agent deployment Interact with deployments eval Interact with evaluations exec Execute commands in task monitor Stream logs from a Nomad agent namespace Interact with namespaces operator Provides cluster-level tools for Nomad operators quota Interact with quotas sentinel Interact with Sentinel policies server Interact with servers system Interact with the system API ui Open the Nomad Web UI version Prints the Nomad version
»Compiling from Source
Clone the Nomad repository from GitHub into your
$ mkdir -p $GOPATH/src/github.com/hashicorp && cd $_ $ git clone https://github.com/hashicorp/nomad.git $ cd nomad
Bootstrap the project. This will download and compile libraries and tools needed to compile Nomad:
$ make bootstrap
Build Nomad for your current system and put the binary in
./bin/(relative to the git checkout). The
make devtarget is just a shortcut that builds
nomadfor only your local build environment (no cross-compiled targets).
$ make dev