github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/server/force-leave.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: server force-leave'
     4  description: >
     5    The server force-leave command is used to force a server into the "left"
     6    state.
     7  ---
     8  
     9  # Command: server force-leave
    10  
    11  The `server force-leave` command forces a server to enter the "left" state.
    12  This can be used to eject server nodes which have failed and will not rejoin
    13  the cluster. Note that if the server is actually still alive, it will
    14  eventually rejoin the cluster again.
    15  
    16  ## Usage
    17  
    18  ```plaintext
    19  nomad server force-leave [options] <node>
    20  ```
    21  
    22  This command expects only one argument - the node which should be forced
    23  to enter the "left" state.
    24  
    25  If ACLs are enabled, this option requires a token with the `agent:write`
    26  capability.
    27  
    28  ## General Options
    29  
    30  @include 'general_options_no_namespace.mdx'
    31  
    32  ## Examples
    33  
    34  Force-leave the server "node1":
    35  
    36  ```shell-session
    37  $ nomad server force-leave node1
    38  
    39  ```