History

Seth Hoenig 1f360ebe1c dist: clarify minimum systemd version for example service file		2021-02-23 09:06:27 -06:00
..
systemd	dist: place systemd unit options correctly	2021-02-22 19:23:00 -06:00
upstart	dist: make README consistent with service unit (#7648 )	2020-04-08 09:32:03 -04:00
README.md	dist: clarify minimum systemd version for example service file	2021-02-23 09:06:27 -06:00
client.hcl	chore: Format hcl configurations	2019-07-20 16:55:07 +02:00
server.hcl	chore: Format hcl configurations	2019-07-20 16:55:07 +02:00

README.md

Dist

The dist folder contains sample configs for various platforms.

Conventions

On unixes we will place agent configs under /etc/nomad.d and store data under /var/lib/nomad/. You will need to create both of these directories. We assume that nomad is installed to /usr/local/bin/nomad.

Agent Configs

The following example configuration files are provided:

server.hcl
client.hcl

Place one of these under /etc/nomad.d depending on the node's role. You should use server.hcl to configure a node as a server (which is responsible for scheduling) or client.hcl to configure a node as a client (which is responsible for running workloads).

Read https://nomadproject.io/docs/agent/configuration/index.html to learn which options are available and how to configure them.

Systemd

On systems using systemd the basic systemd unit file under systemd/nomad.service starts and stops the nomad agent. Place it under /etc/systemd/system/nomad.service.

You can control Nomad with systemctl start|stop|restart nomad.

The system/nomad.service unit file is compatible with systemd v230 or higher.

Upstart

On systems using upstart the basic upstart file under upstart/nomad.conf starts and stops the nomad agent. Place it under /etc/init/nomad.conf.

You can control Nomad with start|stop|restart nomad.