github.com/iqoqo/nomad@v0.11.3-0.20200911112621-d7021c74d101/website/pages/docs/install/index.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: Installing Nomad
     4  sidebar_title: Installing Nomad
     5  description: Learn how to install Nomad.
     6  ---
     7  
     8  # Installing Nomad
     9  
    10  Installing Nomad is simple. There are two approaches to installing Nomad:
    11  
    12  1. Using a [precompiled binary](#precompiled-binaries)
    13  1. Installing [from source](#from-source)
    14  
    15  Downloading a precompiled binary is easiest, and we provide downloads over
    16  TLS along with SHA-256 sums to verify the binary.
    17  
    18  ## Precompiled Binaries ((#precompiled-binaries))
    19  
    20  To install the precompiled binary,
    21  [download](/downloads) the appropriate package for your system.
    22  Nomad is currently packaged as a zip file. We do not have any near term
    23  plans to provide system packages.
    24  
    25  Once the zip is downloaded, unzip it into any directory. The
    26  `nomad` (or `nomad.exe` for Windows) binary inside is all that is
    27  necessary to run Nomad. Any additional files, if any, are not
    28  required to run Nomad.
    29  
    30  Copy the binary to anywhere on your system. If you intend to access it
    31  from the command-line, make sure to place it somewhere on your `PATH`.
    32  
    33  ## Compiling from Source ((#from-source))
    34  
    35  To compile from source, you will need [Go](https://golang.org) installed and
    36  configured properly (including a `GOPATH` environment variable set), as well
    37  as a copy of [`git`](https://www.git-scm.com/) in your `PATH`.
    38  
    39  1. Clone the Nomad repository from GitHub into your `GOPATH`:
    40  
    41     ```shell
    42     $ mkdir -p $GOPATH/src/github.com/hashicorp && cd $_
    43     $ git clone https://github.com/hashicorp/nomad.git
    44     $ cd nomad
    45     ```
    46  
    47  1. Bootstrap the project. This will download and compile libraries and tools
    48     needed to compile Nomad:
    49  
    50     ```shell
    51     $ make bootstrap
    52     ```
    53  
    54  1. Build Nomad for your current system and put the
    55     binary in `./bin/` (relative to the git checkout). The `make dev` target is
    56     just a shortcut that builds `nomad` for only your local build environment (no
    57     cross-compiled targets).
    58  
    59     ```shell
    60     $ make dev
    61     ```
    62  
    63  ## Verifying the Installation
    64  
    65  To verify Nomad is properly installed, run `nomad -v` on your system. You should
    66  see help output. If you are executing it from the command line, make sure it is
    67  on your `PATH` or you may get an error about `nomad` not being found.
    68  
    69  ```shell-sessionnomad -v
    70  
    71  ```