docker stack ls

Estimated reading time: 1 minute

Description

List stacks

Usage

docker stack ls

Options

Name, shorthand Default Description
--format   Pretty-print stacks using a Go template

Parent command

Command Description
docker stack Manage Docker stacks
Command Description
docker stack deploy Deploy a new stack or update an existing stack
docker stack ls List stacks
docker stack ps List the tasks in the stack
docker stack rm Remove one or more stacks
docker stack services List the services in the stack

Extended description

Lists the stacks.

Examples

The following command shows all stacks and some additional information:

$ docker stack ls

ID                 SERVICES
vossibility-stack  6
myapp              2

Formatting

The formatting option (--format) pretty-prints stacks using a Go template.

Valid placeholders for the Go template are listed below:

Placeholder Description
.Name Stack name
.Services Number of services

When using the --format option, the stack ls command either outputs the data exactly as the template declares or, when using the table directive, includes column headers as well.

The following example uses a template without headers and outputs the Name and Services entries separated by a colon for all stacks:

$ docker stack ls --format "{{.Name}}: {{.Services}}"
web-server: 1
web-cache: 4