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.
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
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
.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.
If your shell profile does not already export
PATH, add the export command with the directory.
Save the file and reload your current shell with the
source command and the shell profile you modified.
$ source ~/.bash_profile
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
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.