Install Nomad

To simplify the getting started experience, you can download a precompiled binary and run it on your machine locally.

After downloading Nomad, unzip the package. The nomad binary file needs to be moved to a location on your system's path.

Inspect the locations available on your path.

$ echo $PATH
/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

The output is a list of locations separated by colons and yours may be different from the example output.

You can move the Nomad binary to a directory in your path or to a directory of your choice and add that directory to your path. In this example, the binary has been unzipped to /opt/hashicorp.

Add the Nomad binary directory to your system path by updating your shell's profile. This ensures that every time a new shell starts, the Nomad binary will be available on the path. Depending on the shell your system uses, this file could be .profile, .bash_profile, or similar but usually resides in your user's home directory.

If your shell profile already exports PATH, add the directory to the same line by first adding a colon (:) separator and then the directory.

export PATH=/usr/local:/opt/bin:/opt/hashicorp

If your shell profile does not already export PATH, add the export command with the directory.

export PATH=/opt/hashicorp

Save the file and reload your current shell with the source command and the shell profile you modified.

$ source ~/.bash_profile

Homebrew is a free and open source package management system for macOS. Install the official Nomad formula from the terminal.

First, install the HashiCorp tap, a repository of all of the HashiCorp Homebrew packages.

$ brew tap hashicorp/tap

Now, install Nomad with hashicorp/tap/nomad. This installs a signed binary of the newest available official release.

$ brew install hashicorp/tap/nomad

To update to the latest, run:

$ brew upgrade hashicorp/tap/nomad

Chocolatey is a free and open source package management system for Windows. Install the Nomad package from the command-line.

$ choco install nomad

HashiCorp does not directly maintain Chocolatey or the Nomad package it installs. The latest version of Nomad is always available by manual installation.

HashiCorp officially maintains and signs packages for the following Linux distributions.

$ sudo apt-get update && \
  sudo apt-get install wget gpg coreutils

$ wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg

$ echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list

$ sudo apt-get update && sudo apt-get install nomad

$ sudo yum install -y yum-utils

$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo

$ sudo yum -y install nomad

$ sudo dnf install -y dnf-plugins-core

$ sudo dnf config-manager --add-repo https://rpm.releases.hashicorp.com/fedora/hashicorp.repo

$ sudo dnf -y install nomad

$ sudo yum install -y yum-utils

$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo

$ sudo yum -y install nomad

Note that you can also install Terraform, Vault, Consul, and Packer with the same command now that the HashiCorp repository exists in your package manager.