Install Nomad

4min
|
Nomad

In this collection of tutorials, you will become familiar with Nomad by installing the CLI tool, creating a cluster, and deploying an application.

In this tutorial, you will install the Nomad CLI on your local machine and verify its functionality.

Install the Nomad CLI

Nomad is available as a pre-compiled binary or as a package for several operating systems. Refer to the Nomad downloads page for the most up-to-date instructions.

Note

This collection of tutorials requires Nomad version 1.5.0 or later.

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.

Tip

Depending on the shell your system uses, this file could be .profile, .bash_profile, or similar but will usually reside 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.

~/.bash_profile

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

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

~/.bash_profile

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 Mac OS X. 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.

$ brew install hashicorp/tap/nomad

Tip

This installs a signed binary and is automatically updated with every new official release.

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

Tip

Chocolatey and the Nomad package are not directly maintained by HashiCorp. The latest version of Nomad is always available by manual installation.

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

Install the required packages.

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

Add the HashiCorp GPG key.

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

Add the official HashiCorp Linux repository.

$ 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

Update and install Nomad.

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

Install yum-config-manager to manage your repositories.

$ sudo yum install -y yum-utils

Use yum-config-manager to add the official HashiCorp Linux repository.

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

Install Nomad.

$ sudo yum -y install nomad

Install dnf config-manager to manage your repositories.

$ sudo dnf install -y dnf-plugins-core

Use dnf config-manager to add the official HashiCorp Linux repository.

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

Install Nomad.

$ sudo dnf -y install nomad

Install yum-config-manager to manage your repositories.

$ sudo yum install -y yum-utils

Use yum-config-manager to add the official HashiCorp Linux repository.

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

Install Nomad.

$ sudo yum -y install nomad

Tip

Now that you have added the HashiCorp repository, you can install Terraform, Vault, Consul, and Packer with the same command.

Verify the installation

Verify Nomad is functioning by checking the version.

$ nomad -v
Nomad v1.5.0
BuildDate 2023-03-01T10:11:42Z
Revision fc40c491cacec3d8ec3f2f98cd82b9068a50797c

Next steps

In this tutorial you installed Nomad on your local machine. Continue on to the next tutorial by clicking on the Next button below and learn how to start a Nomad cluster.

Nomad introduction

Create a cluster