nomad/website/source/docs/commands/agent-force-leave.html.md

layout, page_title, sidebar_current, description

layout	page_title	sidebar_current	description
docs	Commands: agent-force-leave	docs-commands-agent-force-leave	Force a node into the "left" state.

Command: agent-force-leave

The agent-force-leave command forces an agent to enter the "left" state. This can be used to eject nodes which have failed and will not rejoin the cluster. Note that if the member is actually still alive, it will eventually rejoin the cluster again.

Usage

nomad agent-force-leave [options] <node>

This command expects only one argument - the node which should be forced to enter the "left" state.

General Options

• -address: The address of the Nomad server. Overrides the NOMAD_ADDR environment variable if set. Defaults to http://127.0.0.1:4646.

Examples

Force-leave the node "node1":

$ nomad agent-force-leave node1