---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# docker node

> Manage Docker Swarm nodes.
> More information: <https://docs.docker.com/reference/cli/docker/node/>.

- List nodes in the swarm:

`docker node ls`

- List tasks running on one or more nodes, defaults to the current node:

`docker node ps {{node1 node2 node3 ...}}`

- Display detailed information on one or more nodes:

`docker node inspect {{node1 node2 node3 ...}}`

- Promote one or more nodes to manager in the swarm:

`docker node promote {{node1 node2 node3 ...}}`

- Demote one or more nodes from manager in the swarm:

`docker node demote {{node1 node2 node3 ...}}`

- Remove one or more nodes from the swarm:

`docker node rm {{node1 node2 node3 ...}}`

- Update metadata about a node, such as its availability, labels, or roles:

`docker node update --{{availability|role|label-add|...}} {{active|worker|foo|...}} {{node1}}`
