list CLI command reference

Detailed information on the list CLI command

Description

List all Dapr instances.

Supported platforms

Usage

  1. dapr list [flags]

Flags

NameEnvironment VariableDefaultDescription
—all-namespaces, -AfalseList all Dapr pods in all namespaces (optional)
—help, -hPrint this help message
—kubernetes, -kfalseList all Dapr pods in a Kubernetes cluster (optional)
—namespace, -ndefaultList the Dapr pods in the defined namespace in Kubernetes. Only with -k flag (optional)
—output, -otableThe output format of the list. Valid values are: json, yaml, or table

Examples

  1. # List Dapr instances in self-hosted mode
  2. dapr list
  4. # List Dapr instances in all namespaces in Kubernetes mode
  5. dapr list -k
  7. # List Dapr instances in JSON format
  8. dapr list -o json
  10. # List Dapr instances in a specific namespace in Kubernetes mode
  11. dapr list -k --namespace default
  13. # List Dapr instances in all namespaces in  Kubernetes mode
  14. dapr list -k --all-namespaces

Warning messages - Kubernetes Mode

This command can issue warning messages.

Root certificate renewal warning

If the mtls root certificate deployed to the Kubernetes cluster expires in under 30 days the following warning message is displayed:

  1. Dapr root certificate of your Kubernetes cluster expires in <n> days. Expiry date: <date:time> UTC. 
  2. Please see docs.dapr.io for certificate renewal instructions to avoid service interruptions.

Last modified April 1, 2022: Addressing review comments (72af4c74)