# Nomad > HashiCorp Nomad cluster orchestration. Query jobs, nodes, allocations, deployments, and services. Run, stop, and scale jobs. Monitor logs and troubleshoot workloads. Use for container orchestration, job scheduling, and cluster management. - Skill: `danfedick/nomad` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add danfedick/nomad` - Raw SKILL.md: https://api.skillmd.com/api/skills/danfedick/nomad/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: danfedick (https://skillmd.com/u/danfedick) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/danfedick/nomad --- # Nomad Skill Orchestrate workloads with the HashiCorp Nomad CLI. ## Requirements - `nomad` CLI installed - `NOMAD_ADDR` environment variable (default: http://127.0.0.1:4646) - `NOMAD_TOKEN` if ACLs are enabled ## Jobs ### List & Status ```bash nomad job status # List all jobs nomad job status # Job details nomad job status -verbose # Detailed info ``` ### Run & Stop ```bash nomad job run job.nomad.hcl # Deploy job nomad job run -check-index=X job.hcl # Deploy only if index matches nomad job plan job.nomad.hcl # Dry-run, show changes nomad job stop # Stop job (leaves history) nomad job stop -purge # Stop and remove completely ``` ### Scale ```bash nomad job scale 5 # Scale to 5 instances nomad job scale -detach 3 ``` ### Dispatch (Parameterized Jobs) ```bash nomad job dispatch nomad job dispatch -meta key=value nomad job dispatch -meta key=value @payload.json ``` ### History & Versions ```bash nomad job history nomad job revert nomad job deployments ``` ### Inspect ```bash nomad job inspect # Full job spec JSON nomad job validate job.nomad.hcl # Validate syntax ``` ## Allocations ```bash nomad job allocs # List job allocations nomad alloc status # Allocation details nomad alloc status -short # Summary only ``` ### Logs ```bash nomad alloc logs # stdout nomad alloc logs -stderr # stderr nomad alloc logs -f # Follow nomad alloc logs -tail -n 100 nomad alloc logs -job # Latest alloc logs nomad alloc logs # Specific task ``` ### Exec ```bash nomad alloc exec /bin/sh nomad alloc exec -task /bin/sh nomad alloc exec -i -t /bin/bash ``` ### Files ```bash nomad alloc fs # List / nomad alloc fs /alloc/logs/ # List directory nomad alloc fs -stat /path # File metadata nomad alloc fs -tail -f /alloc/logs/app.stdout.0 ``` ### Actions ```bash nomad alloc stop # Stop allocation nomad alloc restart # Restart all tasks nomad alloc restart -task web # Restart specific task nomad alloc signal -s SIGHUP # Send signal ``` ## Nodes ```bash nomad node status # List nodes nomad node status # Node details nomad node status -allocs # Show allocations nomad node status -verbose # Full details ``` ### Node Management ```bash nomad node drain -enable # Drain for maintenance nomad node drain -disable # Stop draining nomad node eligibility -enable # Allow scheduling nomad node eligibility -disable # Prevent scheduling ``` ## Deployments ```bash nomad deployment list nomad deployment status nomad deployment promote # Promote canary nomad deployment fail # Mark failed nomad deployment pause nomad deployment resume ``` ## Evaluations ```bash nomad eval list nomad eval status ``` ## Services ```bash nomad service list nomad service info nomad service delete # Force delete ``` ## Namespaces ```bash nomad namespace list nomad namespace status nomad namespace apply -description "Prod" production nomad namespace delete ``` ## Variables ```bash nomad var list nomad var get nomad var put key=value key2=value2 nomad var put @data.json nomad var purge ``` ## ACLs ```bash nomad acl policy list nomad acl policy info nomad acl token list nomad acl token self # Current token info ``` ## Cluster ```bash nomad server members # Raft cluster nomad operator raft list-peers # Raft peers nomad agent-info # Local agent info nomad operator snapshot save backup.snap nomad operator snapshot restore backup.snap ``` ## JSON Output Add `-json` to most commands: ```bash nomad job status -json nomad node status -json nomad alloc status -json ``` ## Filtering Use `-filter` with expressions: ```bash nomad job status -filter='Status == "running"' nomad node status -filter='Status == "ready"' nomad job allocs -filter='ClientStatus == "failed"' ``` ## Common Patterns ### Logs from latest allocation ```bash nomad alloc logs $(nomad job allocs -json | jq -r '.[0].ID') ``` ### Find failed allocations ```bash nomad job allocs | grep -i failed nomad eval list -filter='Status == "blocked"' ``` ### Quick restart ```bash nomad job stop && nomad job run job.nomad.hcl ``` ### Force new deployment ```bash nomad job run -force job.nomad.hcl ``` ### Exec into running container ```bash ALLOC=$(nomad job allocs -json | jq -r '.[0].ID') nomad alloc exec -i -t $ALLOC /bin/sh ``` ### Watch deployment ```bash nomad deployment status -monitor ``` ### Scale to zero and back ```bash nomad job scale 0 nomad job scale 3 ``` ## Environment Variables - `NOMAD_ADDR` — API address (default: http://127.0.0.1:4646) - `NOMAD_TOKEN` — ACL token - `NOMAD_NAMESPACE` — Default namespace - `NOMAD_REGION` — Default region - `NOMAD_CACERT` / `NOMAD_CLIENT_CERT` / `NOMAD_CLIENT_KEY` — TLS config - `NOMAD_TLS_SERVER_NAME` — TLS server name for verification ## Tips - Use `nomad-tui` for interactive cluster management - Use `-monitor` flag with deployments to watch progress - Prefix alloc IDs work (e.g., `nomad alloc logs abc123` if unique) - `-detach` returns immediately without waiting - `-verbose` adds scheduling info and constraint details