Install the Dapr CLI

The Dapr CLI is the main tool you’ll be using for various Dapr related tasks. You can use it to run an application with a Dapr sidecar, as well as review sidecar logs, list running services, and run the Dapr dashboard. The Dapr CLI works with both self-hosted and Kubernetes environments.

Begin by downloading and installing the Dapr CLI:

This command installs the latest linux Dapr CLI to /usr/local/bin:

  1. wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | /bin/bash

This Command Prompt command installs the latest windows Dapr cli to C:\dapr and adds this directory to User PATH environment variable.

  1. powershell -Command "iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1 | iex"

This command installs the latest darwin Dapr CLI to /usr/local/bin:

  1. curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh | /bin/bash

Or you can install via Homebrew:

  1. brew install dapr/tap/dapr-cli

Note for M1 Macs

For M1 Macs, homebrew is not supported. You will need to use the dapr install script and have the rosetta amd64 compatibility layer installed. If you do not have it installed already, you can run the following:

  1. softwareupdate --install-rosetta

Each release of Dapr CLI includes various OSes and architectures. These binary versions can be manually downloaded and installed.

  1. Download the desired Dapr CLI from the latest Dapr Release
  2. Unpack it (e.g. dapr_linux_amd64.tar.gz, dapr_windows_amd64.zip)
  3. Move it to your desired location.
    • For Linux/MacOS - /usr/local/bin
    • For Windows, create a directory and add this to your System PATH. For example create a directory called C:\dapr and add this directory to your User PATH, by editing your system environment variable.

Step 2: Verify the installation

You can verify the CLI is installed by restarting your terminal/command prompt and running the following:

  1. dapr

The output should look like this:

  1.          __
  2.     ____/ /___ _____  _____
  3.    / __  / __ '/ __ \/ ___/
  4.   / /_/ / /_/ / /_/ / /
  5.   \__,_/\__,_/ .___/_/
  6.               /_/
  8. ===============================
  9. Distributed Application Runtime
  11. Usage:
  12.   dapr [command]
  14. Available Commands:
  15.   completion     Generates shell completion scripts
  16.   components     List all Dapr components. Supported platforms: Kubernetes
  17.   configurations List all Dapr configurations. Supported platforms: Kubernetes
  18.   dashboard      Start Dapr dashboard. Supported platforms: Kubernetes and self-hosted
  19.   help           Help about any command
  20.   init           Install Dapr on supported hosting platforms. Supported platforms: Kubernetes and self-hosted
  21.   invoke         Invoke a method on a given Dapr application. Supported platforms: Self-hosted
  22.   list           List all Dapr instances. Supported platforms: Kubernetes and self-hosted
  23.   logs           Get Dapr sidecar logs for an application. Supported platforms: Kubernetes
  24.   mtls           Check if mTLS is enabled. Supported platforms: Kubernetes
  25.   publish        Publish a pub-sub event. Supported platforms: Self-hosted
  26.   run            Run Dapr and (optionally) your application side by side. Supported platforms: Self-hosted
  27.   status         Show the health status of Dapr services. Supported platforms: Kubernetes
  28.   stop           Stop Dapr instances and their associated apps. . Supported platforms: Self-hosted
  29.   uninstall      Uninstall Dapr runtime. Supported platforms: Kubernetes and self-hosted
  30.   upgrade        Upgrades a Dapr control plane installation in a cluster. Supported platforms: Kubernetes
  32. Flags:
  33.   -h, --help      help for dapr
  34.   -v, --version   version for dapr
  36. Use "dapr [command] --help" for more information about a command.

Next step: Initialize Dapr >>

Last modified May 26, 2021: Update to point to 1.2 (#1518) (c690379)