nomad(1)
Nomad is a flexible workload orchestrator that deploys and manages containers, VMs, and batch jobs across on-premise and cloud infrastructure.
Synopsis
nomad [GLOBAL OPTIONS] COMMAND [OPTIONS] [ARGS]Description
Nomad is HashiCorp's open-source cluster scheduler and orchestrator for deploying applications at scale. It supports multiple workload types including Docker containers, VMs via QEMU, Java applications, and raw binaries, making it suitable for both microservices and batch processing workloads.
Nomad operates in a client-server architecture where servers manage job placement decisions and clients run the actual workloads. It integrates with service meshes, secrets management systems, and provides sophisticated job scheduling with bin-packing, constraint evaluation, and multi-region federation.
Common options
| Flag | What it does |
|---|---|
-address=<addr> | The address of the Nomad server; overrides NOMAD_ADDR environment variable |
-region=<region> | Nomad region to query; defaults to client's local region |
-namespace=<ns> | Target namespace for the operation; enterprise feature |
-token=<token> | ACL token for authentication; overrides NOMAD_TOKEN environment variable |
-ca-cert=<path> | Path to a CA certificate for TLS verification |
-client-cert=<path> | Path to a client certificate for mutual TLS authentication |
-client-key=<path> | Path to a client key for mutual TLS authentication |
-tls-skip-verify | Skip TLS certificate verification; not recommended for production |
-json | Output results in JSON format |
-verbose | Enable verbose output for debugging |
Examples
Submit a job defined in example.nomad file to the cluster
nomad job run example.nomadDisplay the status of the job named 'my-app' including allocations and task groups
nomad job status my-appStream or retrieve logs from a specific task within an allocation
nomad alloc logs <alloc-id> <task-name>Stop and remove all allocations for the 'my-app' job
nomad job stop my-appList all nodes in the cluster with their status and resource availability
nomad node statusDisplay information about Nomad server cluster members
nomad server membersCheck the rolling deployment status and progress of a canary or blue-green deployment
nomad deployment status <deployment-id>Plan and review job changes before applying them to the cluster
nomad job plan -out=plan.out my-job.nomad && nomad job apply plan.out