github.com/vieux/docker@v0.6.3-0.20161004191708-e097c2a938c7/docs/reference/commandline/node_rm.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "node rm"
     4  description = "The node rm command description and usage"
     5  keywords = ["node, remove"]
     6  [menu.main]
     7  parent = "smn_cli"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # node rm
    12  
    13  ```markdown
    14  Usage:  docker node rm [OPTIONS] NODE [NODE...]
    15  
    16  Remove one or more nodes from the swarm
    17  
    18  Aliases:
    19    rm, remove
    20  
    21  Options:
    22        --force  Force remove an active node
    23        --help   Print usage
    24  ```
    25  
    26  When run from a manager node, removes the specified nodes from a swarm.
    27  
    28  
    29  Example output:
    30  
    31  ```nohighlight
    32  $ docker node rm swarm-node-02
    33  
    34  Node swarm-node-02 removed from swarm
    35  ```
    36  
    37  Removes the specified nodes from the swarm, but only if the nodes are in the
    38  down state. If you attempt to remove an active node you will receive an error:
    39  
    40  ```nohighlight
    41  $ docker node rm swarm-node-03
    42  
    43  Error response from daemon: rpc error: code = 9 desc = node swarm-node-03 is not
    44  down and can't be removed
    45  ```
    46  
    47  If you lose access to a worker node or need to shut it down because it has been
    48  compromised or is not behaving as expected, you can use the `--force` option.
    49  This may cause transient errors or interruptions, depending on the type of task
    50  being run on the node.
    51  
    52  ```nohighlight
    53  $ docker node rm --force swarm-node-03
    54  
    55  Node swarm-node-03 removed from swarm
    56  ```
    57  
    58  A manager node must be demoted to a worker node (using `docker node demote`)
    59  before you can remove it from the swarm.
    60  
    61  ## Related information
    62  
    63  * [node inspect](node_inspect.md)
    64  * [node update](node_update.md)
    65  * [node demote](node_demote.md)
    66  * [node ps](node_ps.md)
    67  * [node ls](node_ls.md)