DOCKER(1) Docker User Manuals DOCKER(1)

# [NAME](#NAME)

docker-node-ls - List nodes in the swarm

# [SYNOPSIS](#SYNOPSIS)

**docker node ls \[OPTIONS]**

# [DESCRIPTION](#DESCRIPTION)

List nodes in the swarm

# [OPTIONS](#OPTIONS)

**-f**, **--filter**= Filter output based on conditions provided

**--format**="" Format output using a custom template: 'table': Print output in table format with column headers (default) 'table TEMPLATE': Print output in table format using the given Go template 'json': Print in JSON format 'TEMPLATE': Print output using the given Go template. Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates

**-q**, **--quiet**\[=false] Only display IDs

# [SEE ALSO](#SEE_ALSO)

[**docker-node(1)**](/man/os/docker-cli/docker-node.1)

Oct 2026 Docker Community

---

Document: docker-node-ls(1) from docker-cli 29.9.1-r0 (Chainguard OS)
Source: https://github.com/docker/cli