github.com/Ilhicas/nomad@v1.0.4-0.20210304152020-e86851182bc3/website/content/docs/commands/server/force-leave.mdx (about)

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