docker stack ls
Description
List stacks
API 1.25+ The client and daemon API must both be at least 1.25 to use this command. Use the docker version command on the client to check your client and daemon API versions.
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 |
Related commands
| 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
© 2019 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.
https://docs.docker.com/v17.12/engine/reference/commandline/stack_ls/