docker swarm leaveEstimated reading time: 2 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.
Leave the swarm
The client and daemon API must both be at least
to use this command. Use the
docker version command on the client to check
your client and daemon API versions.
docker swarm leave [OPTIONS]
||Force this node to leave the swarm, ignoring warnings|
|docker swarm||Manage Swarm|
|docker swarm ca||Display and rotate the root CA|
|docker swarm init||Initialize a swarm|
|docker swarm join||Join a swarm as a node and/or manager|
|docker swarm join-token||Manage join tokens|
|docker swarm leave||Leave the swarm|
|docker swarm unlock||Unlock swarm|
|docker swarm unlock-key||Manage the unlock key|
|docker swarm update||Update the swarm|
When you run this command on a worker, that worker leaves the swarm.
You can use the
--force option on a manager to remove it from the swarm.
However, this does not reconfigure the swarm to ensure that there are enough
managers to maintain a quorum in the swarm. The safe way to remove a manager
from a swarm is to demote it to a worker and then direct it to leave the quorum
--force. Only use
--force in situations where the swarm will
no longer be used after the manager leaves, such as in a single-node swarm.
Consider the following swarm, as seen from the manager:
$ docker node ls ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS 7ln70fl22uw2dvjn2ft53m3q5 worker2 Ready Active dkp8vy1dq1kxleu9g4u78tlag worker1 Ready Active dvfxp4zseq4s0rih1selh0d20 * manager1 Ready Active Leader
worker2, issue the following command from
$ docker swarm leave Node left the default swarm.
The node will still appear in the node list, and marked as
down. It no longer
affects swarm operation, but a long list of
down nodes can clutter the node
list. To remove an inactive node from the list, use the