open-nomad/website/pages/docs/install/quickstart.mdx

---
layout: docs
page_title: Installing Nomad for QuickStart
sidebar_title: Quickstart
description: Learn how to install Nomad locally or in a sandbox.
---

# Quickstart

This page lists multiple methods to installing Nomad locally or in a sandbox
environment.

These installations are designed to get you started with Nomad easily and should
be used only for experimentation purposes. If you are looking to install Nomad
in production, please refer to our [Production Installation](/docs/install/production) guide here.

<Tabs>
<Tab heading="Interactive Online Environment">

Experiment with Nomad in your browser via the Katacoda interactive learning platform.

- [Introduction to Nomad](https://www.katacoda.com/hashicorp/scenarios/nomad-introduction)

- [Nomad Playground](https://katacoda.com/hashicorp/scenarios/playground)

</Tab>
<Tab heading="Create a Cloud Lab">

Install Nomad on the public cloud.

- AWS

  - [CloudFormation](https://aws.amazon.com/quickstart/architecture/nomad/)

  - [Terraform](https://github.com/hashicorp/nomad/blob/master/terraform/aws/README.md)

- Azure

  - [Terraform](https://github.com/hashicorp/nomad/tree/master/terraform/azure)

</Tab>
<Tab heading="Try it Locally">

## Install Nomad on your machine

If you would like to try Nomad locally, you can install Nomad on your local
machine using the same steps that you would for a production environments and
run a single-node development instance using the `nomad agent -dev` command

[Installing Nomad][installing-binary]

## Run Nomad in Vagrant

Alternatively, you can use a Vagrant to set up a development environment for Nomad.
Vagrant is a tool for building and managing virtual machine environments.

-> **Note**: To use the Vagrant environment, first install Vagrant following
these [instructions](https://www.vagrantup.com/docs/installation/). You will
also need a virtualization tool, such as [VirtualBox][].

You can download a Vagrantfile which will start a small Nomad cluster. First
create a new directory for your Vagrant environment.

```shell-session
$ mkdir nomad-vagrant
```

Change into the directory you made with the previous command.

```shell-session
$ cd nomad-vagrant
```

Now you can get the Nomad installation configuration.

```shell-session
$ curl -O https://raw.githubusercontent.com/hashicorp/nomad/master/demo/vagrant/Vagrantfile
```

Now that you have created a new directory and downloaded the `Vagrantfile`
you must create the virtual machine with the `vagrant up` command.

```shell-session
$ vagrant up
```

This will take a few minutes as the base Ubuntu box must be downloaded
and provisioned with both Docker and Nomad. Once this completes, you should
see this output.

```plaintext
Bringing machine 'default' up with 'virtualbox' provider...
==> default: Importing base box 'bento/ubuntu-18.04'...
...
==> default: Running provisioner: docker...
```

At this point the Vagrant box is running and ready to go.

</Tab>
</Tabs>

[installing-binary]: /docs/install#precompiled-binaries
[vagrant-environment]: https://learn.hashicorp.com/tutorials/nomad/get-started-install#vagrant-setup-optional
[virtualbox]: https://www.virtualbox.org/