github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/install/quickstart.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: Installing Nomad for QuickStart
     4  description: Learn how to install Nomad locally or in a sandbox.
     5  ---
     6  
     7  # Quickstart
     8  
     9  This page lists multiple methods to installing Nomad locally or in a sandbox
    10  environment.
    11  
    12  These installations are designed to get you started with Nomad easily and should
    13  be used only for experimentation purposes. If you are looking to install Nomad
    14  in production, please refer to the [Production Installation](/docs/install/production) guide here.
    15  
    16  <Tabs>
    17  <Tab heading="Interactive Online Environment">
    18  
    19  Experiment with Nomad in your browser via guides containing embedded interactive learning environments.
    20  
    21  - [Interactive Labs](https://learn.hashicorp.com/collections/nomad/interactive)
    22  
    23  </Tab>
    24  <Tab heading="Create a Cloud Lab">
    25  
    26  Install Nomad on the public cloud.
    27  
    28  - AWS
    29  
    30    - [CloudFormation](https://aws.amazon.com/quickstart/architecture/nomad/)
    31  
    32    - [Terraform](https://github.com/hashicorp/nomad/blob/master/terraform/aws/README.md)
    33  
    34  - Azure
    35  
    36    - [Terraform](https://github.com/hashicorp/nomad/tree/master/terraform/azure)
    37  
    38  </Tab>
    39  <Tab heading="Try it Locally">
    40  
    41  ## Install Nomad on your machine
    42  
    43  If you would like to try Nomad locally, you can install Nomad on your local
    44  machine using the same steps that you would for a production environments and
    45  run a single-node development instance using the `nomad agent -dev` command
    46  
    47  [Installing Nomad][installing-binary]
    48  
    49  -> **Note:** If you are using Docker Desktop for Windows or MacOS, please check
    50  [our FAQ][faq-win-mac].
    51  
    52  ## Run Nomad in Vagrant
    53  
    54  Alternatively, you can use a Vagrant to set up a development environment for Nomad.
    55  Vagrant is a tool for building and managing virtual machine environments.
    56  
    57  -> **Note**: To use the Vagrant environment, first install Vagrant following
    58  these [instructions](https://www.vagrantup.com/docs/installation). You will
    59  also need a virtualization tool, such as [VirtualBox][].
    60  
    61  You can download a Vagrantfile which can start a small Nomad cluster. First
    62  create a new directory for your Vagrant environment.
    63  
    64  ```shell-session
    65  $ mkdir nomad-vagrant
    66  ```
    67  
    68  Change into the directory you made with the previous command.
    69  
    70  ```shell-session
    71  $ cd nomad-vagrant
    72  ```
    73  
    74  Now you can get the Nomad installation configuration.
    75  
    76  ```shell-session
    77  $ curl -O https://raw.githubusercontent.com/hashicorp/nomad/master/demo/vagrant/Vagrantfile
    78  ```
    79  
    80  Now that you have created a new directory and downloaded the `Vagrantfile`
    81  you must create the virtual machine with the `vagrant up` command.
    82  
    83  ```shell-session
    84  $ vagrant up
    85  ```
    86  
    87  This takes a few minutes as the base Ubuntu box must be downloaded
    88  and provisioned with both Docker and Nomad. Once this completes, you should
    89  see this output.
    90  
    91  ```plaintext
    92  Bringing machine 'default' up with 'virtualbox' provider...
    93  ==> default: Importing base box 'bento/ubuntu-18.04'...
    94  ...
    95  ==> default: Running provisioner: docker...
    96  ```
    97  
    98  At this point the Vagrant box is running and ready to go.
    99  
   100  </Tab>
   101  </Tabs>
   102  
   103  [faq-win-mac]: /docs/faq#q-how-to-connect-to-my-host-network-when-using-docker-desktop-windows-and-macos
   104  [installing-binary]: /docs/install#precompiled-binaries
   105  [vagrant-environment]: https://learn.hashicorp.com/tutorials/nomad/get-started-install#vagrant-setup-optional
   106  [virtualbox]: https://www.virtualbox.org/