terraform/website/source/docs/providers/nomad/index.html.markdown

---
layout: "nomad"
page_title: "Provider: Nomad"
sidebar_current: "docs-nomad-index"
description: |-
  Nomad is a cluster scheduler. The Nomad provider exposes resources to interact with a Nomad cluster.
---

# Nomad Provider

[Nomad](https://www.nomadproject.io) is a cluster scheduler. The Nomad
provider exposes resources to interact with a Nomad cluster.

Use the navigation to the left to read about the available resources.

## Example Usage

```hcl
# Configure the Nomad provider
provider "nomad" {
  address = "nomad.mycompany.com"
  region  = "us-east-2"
}

# Register a job
resource "nomad_job" "monitoring" {
  jobspec = "${file("${path.module}/jobspec.hcl")}"
}
```

## Argument Reference

The following arguments are supported:

* `address` - (Optional) The HTTP(S) API address of the Nomad agent to use. Defaults to `http://127.0.0.1:4646`. The `NOMAD_ADDR` environment variable can also be used.
* `region` - (Optional) The Nomad region to target. The `NOMAD_REGION` environment variable can also be used.
provider/nomad 2016-10-24 08:18:04 +02:00			`---`
			`layout: "nomad"`
			`page_title: "Provider: Nomad"`
			`sidebar_current: "docs-nomad-index"`
			`description: \|-`
			`Nomad is a cluster scheduler. The Nomad provider exposes resources to interact with a Nomad cluster.`
			`---`

			`# Nomad Provider`

			`[Nomad](https://www.nomadproject.io) is a cluster scheduler. The Nomad`
			`provider exposes resources to interact with a Nomad cluster.`

			`Use the navigation to the left to read about the available resources.`

			`## Example Usage`

Update nomad provider 2017-04-10 18:28:09 +02:00			```hcl
provider/nomad 2016-10-24 08:18:04 +02:00			`# Configure the Nomad provider`
			`provider "nomad" {`
website/docs: Run `terraform fmt` on code examples (#12075) * docs/vsphere: Fix code block * docs: Convert `...` to `# ...` to allow `terraform fmt`ing * docs: Trim trailing whitespace * docs: First-pass run of `terraform fmt` on code examples 2017-02-18 23:48:50 +01:00			`address = "nomad.mycompany.com"`
			`region = "us-east-2"`
provider/nomad 2016-10-24 08:18:04 +02:00			`}`

			`# Register a job`
			`resource "nomad_job" "monitoring" {`
website/docs: Run `terraform fmt` on code examples (#12075) * docs/vsphere: Fix code block * docs: Convert `...` to `# ...` to allow `terraform fmt`ing * docs: Trim trailing whitespace * docs: First-pass run of `terraform fmt` on code examples 2017-02-18 23:48:50 +01:00			`jobspec = "${file("${path.module}/jobspec.hcl")}"`
provider/nomad 2016-10-24 08:18:04 +02:00			`}`
			```

			`## Argument Reference`

			`The following arguments are supported:`

Docs: fix incorrect NOMAD_ADDR description Per [provider_test.go#L42](https://github.com/hashicorp/terraform/blob/master/builtin/providers/nomad/provider_test.go#L42). 2017-02-03 14:46:58 +01:00			* `address` - (Optional) The HTTP(S) API address of the Nomad agent to use. Defaults to `http://127.0.0.1:4646`. The `NOMAD_ADDR` environment variable can also be used.
provider/nomad 2016-10-24 08:18:04 +02:00			* `region` - (Optional) The Nomad region to target. The `NOMAD_REGION` environment variable can also be used.