Hashicorp Nomad Dev Install on Debian

Ensure the deb repo is configured and install nomad:

curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
sudo apt-get update && sudo apt-get install nomad

Environment Variables

export NOMAD_ADDR=

Development Mode

These commands are for testing non-production tasks. In this example I am running on a server with IP address

nomad agent -dev -bind -log-level INFO

The web UI will be available on that IP port 4646

Check the status of the node:

nomad node status 
nomad server members
ID        DC   Name         Class   Drain  Eligibility  Status
3829cafc  dc1  consul-1011  <none>  false  eligible     ready

Running a test redis job

nomad job init
nomad job run example.nomad

The init produces a deployment configuration as shown below. The run task runs that job and can be seen in the UI and CLI status commands.

job "example" {
  datacenters = ["dc1"]
  type = "service"
  update {
    max_parallel = 1
    min_healthy_time = "10s"
    healthy_deadline = "3m"
    progress_deadline = "10m"
    auto_revert = false
    canary = 0
  migrate {
    max_parallel = 1
    health_check = "checks"
    min_healthy_time = "10s"
    healthy_deadline = "5m"
  group "cache" {
    count = 1
    network {
      port "db" {
        to = 6379
    service {
      name = "redis-cache"
      tags = ["global", "cache"]
      port = "db"
    restart {
      attempts = 2
      interval = "30m"
      delay = "15s"
      mode = "fail"
    ephemeral_disk {
      size = 300
    task "redis" {
      driver = "docker"
      config {
        image = "redis:3.2"
        ports = ["db"]
      resources {

You can drill down through the Job, Allocation, Task and logs with:

nomad job status example
nomad alloc status 750b05f2
nomad alloc logs 750b05f2 redis

Within the UI you can do the same. The breadcrumb shows the hierarchy of job, group, allocation, job:

Next step is to run Nomad servers with a config file that defines the cluster and agents that will be managed by that cluster.

Leave a Reply

  • (will not be published)

XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>