docker node rmEstimated reading time: 3 minutes
Edge only: This is the CLI reference for Docker CE Edge versions. Some of these options may not be available to Docker CE stable or Docker EE. You can view the stable version of this CLI reference or learn about Docker CE Edge.
Remove one or more nodes from the swarm
Swarm This command works with the Swarm orchestrator.
docker node rm [OPTIONS] NODE [NODE...]
||Force remove a node from the swarm|
|docker node||Manage Swarm nodes|
|docker node demote||Demote one or more nodes from manager in the swarm|
|docker node inspect||Display detailed information on one or more nodes|
|docker node ls||List nodes in the swarm|
|docker node promote||Promote one or more nodes to manager in the swarm|
|docker node ps||List tasks running on one or more nodes, defaults to current node|
|docker node rm||Remove one or more nodes from the swarm|
|docker node update||Update a node|
When run from a manager node, removes the specified nodes from a swarm.
Remove a stopped node from the swarm
$ docker node rm swarm-node-02 Node swarm-node-02 removed from swarm
Attempt to remove a running node from a swarm
Removes the specified nodes from the swarm, but only if the nodes are in the down state. If you attempt to remove an active node you will receive an error:
$ docker node rm swarm-node-03 Error response from daemon: rpc error: code = 9 desc = node swarm-node-03 is not down and can't be removed
Forcibly remove an inaccessible node from a swarm
If you lose access to a worker node or need to shut it down because it has been
compromised or is not behaving as expected, you can use the
This may cause transient errors or interruptions, depending on the type of task
being run on the node.
$ docker node rm --force swarm-node-03 Node swarm-node-03 removed from swarm
A manager node must be demoted to a worker node (using
docker node demote)
before you can remove it from the swarm.