github.com/smintz/nomad@v0.8.3/website/source/docs/commands/operator/raft-remove-peer.html.md.erb (about) 1 --- 2 layout: "docs" 3 page_title: "Commands: operator raft remove-peer" 4 sidebar_current: "docs-commands-operator-raft-remove-peer" 5 description: > 6 Remove a Nomad server from the Raft configuration. 7 --- 8 9 # Command: operator raft remove-peer 10 11 Remove the Nomad server with given address from the Raft configuration. 12 13 There are rare cases where a peer may be left behind in the Raft quorum even 14 though the server is no longer present and known to the cluster. This command 15 can be used to remove the failed server so that it is no longer affects the Raft 16 quorum. If the server still shows in the output of the [`nomad 17 server members`](/docs/commands/server/members.html) command, it is preferable 18 to clean up by simply running [`nomad 19 server force-leave`](/docs/commands/server/force-leave.html) instead of this 20 command. 21 22 See the [Outage Recovery](/guides/outage.html) guide for some examples of how 23 this command is used. For an API to perform these operations programmatically, 24 please see the documentation for the [Operator](/api/operator.html) 25 endpoint. 26 27 ## Usage 28 29 ``` 30 nomad operator raft remove-peer [options] 31 ``` 32 33 ## General Options 34 35 <%= partial "docs/commands/_general_options" %> 36 37 ## Remove Peer Options 38 39 * `-peer-address`: Remove a Nomad server with given address from the Raft 40 configuration. The format is "IP:port" 41 42 * `-peer-id`: Remove a Nomad server with the given ID from the Raft 43 configuration. The format is "id"