You’ll use the Dapr CLI as the main tool for various Dapr-related tasks. You can use it to:
The Dapr CLI works with both self-hosted and Kubernetes environments.
Install the latest Linux Dapr CLI to /usr/local/bin
:
wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | /bin/bash
The following example shows how to install CLI version 1.15.1
. You can also install release candidates by specifying the version (for example, 1.10.0-rc.3
).
wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | /bin/bash -s 1.15.1
sudo
If you do not have access to the sudo
command or your username is not in the sudoers
file, you can install Dapr to an alternate directory via the DAPR_INSTALL_DIR
environment variable. This directory must already exist and be accessible by the current user.
wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | DAPR_INSTALL_DIR="$HOME/dapr" /bin/bash
sudo
The following example shows how to install CLI version 1.15.1
. You can also install release candidates by specifying the version (for example, 1.10.0-rc.3
).
wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | DAPR_INSTALL_DIR="$HOME/dapr" /bin/bash -s 1.15.1
Install the latest windows Dapr cli to $Env:SystemDrive\dapr
and add this directory to the User PATH environment variable:
powershell -Command "iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1 | iex"
Note: Updates to PATH might not be visible until you restart your terminal application.
The following example shows how to install CLI version 1.15.1
. You can also install release candidates by specifying the version (for example, 1.10.0-rc.3
).
powershell -Command "$script=iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1; $block=[ScriptBlock]::Create($script); invoke-command -ScriptBlock $block -ArgumentList 1.15.1"
If you do not have admin rights, you can install Dapr to an alternate directory via the DAPR_INSTALL_DIR
environment variable. The script below creates the directory if it does not exist.
$Env:DAPR_INSTALL_DIR = "<your_alt_install_dir_path>"
$script=iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1; $block=[ScriptBlock]::Create($script); invoke-command -ScriptBlock $block -ArgumentList "", "$Env:DAPR_INSTALL_DIR"
The following example shows how to install CLI version 1.15.1
. You can also install release candidates by specifying the version (for example, 1.10.0-rc.3
).
$Env:DAPR_INSTALL_DIR = "<your_alt_install_dir_path>"
$script=iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1; $block=[ScriptBlock]::Create($script); invoke-command -ScriptBlock $block -ArgumentList "1.15.1", "$Env:DAPR_INSTALL_DIR"
Install the latest Windows Dapr CLI to $Env:SystemDrive\dapr
and add this directory to the user PATH environment variable:
winget install Dapr.CLI
For preview releases:
Install the latest preview release:
winget install Dapr.CLI.Preview
Each release of the Dapr CLI also includes an installer for Windows. You can manually download the MSI:
dapr.msi
from latest Dapr release.$Env:SystemDrive\dapr
.Install
to start the installation. You will see a final message once the installation is complete.Install the latest Darwin Dapr CLI to /usr/local/bin
:
curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh | /bin/bash
The following example shows how to install CLI version 1.15.1
. You can also install release candidates by specifying the version (for example, 1.10.0-rc.3
).
curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh | /bin/bash -s 1.15.1
For ARM64 Macs:
When installing from the terminal, native ARM64 binaries are available.
To install Rosetta emulation:
softwareupdate --install-rosetta
Install via Homebrew:
brew install dapr/tap/dapr-cli
For ARM64 Macs:
For ARM64 Macs, Homebrew 3.0 and higher versions are supported. Update Homebrew to 3.0.0 or higher and then run the command below:
arch -arm64 brew install dapr/tap/dapr-cli
sudo
If you do not have access to the sudo
command or your username is not in the sudoers
file, you can install Dapr to an alternate directory via the DAPR_INSTALL_DIR
environment variable. This directory must already exist and be accessible by the current user.
curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh | DAPR_INSTALL_DIR="$HOME/dapr" /bin/bash
sudo
The following example shows how to install CLI version 1.15.1
. You can also install release candidates by specifying the version (for example, 1.10.0-rc.3
).
curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh | DAPR_INSTALL_DIR="$HOME/dapr" -s 1.15.1
Each release of Dapr CLI includes various OSes and architectures. You can manually download and install these binary versions.
/usr/local/bin
.C:\dapr
.Verify the CLI is installed by restarting your terminal/command prompt and running the following:
dapr -h
Output:
__
____/ /___ _____ _____
/ __ / __ '/ __ \/ ___/
/ /_/ / /_/ / /_/ / /
\__,_/\__,_/ .___/_/
/_/
===============================
Distributed Application Runtime
Usage:
dapr [command]
Available Commands:
completion Generates shell completion scripts
components List all Dapr components. Supported platforms: Kubernetes
configurations List all Dapr configurations. Supported platforms: Kubernetes
dashboard Start Dapr dashboard. Supported platforms: Kubernetes and self-hosted
help Help about any command
init Install Dapr on supported hosting platforms. Supported platforms: Kubernetes and self-hosted
invoke Invoke a method on a given Dapr application. Supported platforms: Self-hosted
list List all Dapr instances. Supported platforms: Kubernetes and self-hosted
logs Get Dapr sidecar logs for an application. Supported platforms: Kubernetes
mtls Check if mTLS is enabled. Supported platforms: Kubernetes
publish Publish a pub-sub event. Supported platforms: Self-hosted
run Run Dapr and (optionally) your application side by side. Supported platforms: Self-hosted
status Show the health status of Dapr services. Supported platforms: Kubernetes
stop Stop Dapr instances and their associated apps. . Supported platforms: Self-hosted
uninstall Uninstall Dapr runtime. Supported platforms: Kubernetes and self-hosted
upgrade Upgrades a Dapr control plane installation in a cluster. Supported platforms: Kubernetes
version Print the Dapr runtime and CLI version
Flags:
-h, --help help for dapr
-v, --version version for dapr
Use "dapr [command] --help" for more information about a command.