3.5 KiB
type | title | linkTitle | weight | description | aliases | |
---|---|---|---|---|---|---|
docs | Initialize Dapr in your local environment | Init Dapr locally | 20 | Fetch the Dapr sidecar binaries and install them locally using `dapr init` |
|
Now that you've [installed the Dapr CLI]({{}}), use the CLI to initialize Dapr on your local machine.
Dapr runs as a sidecar alongside your application. In self-hosted mode, this means it is a process on your local machine. By initializing Dapr, you:
- Fetch and install the Dapr sidecar binaries locally.
- Create a development environment that streamlines application development with Dapr.
Dapr initialization includes:
- Running a Redis container instance to be used as a local state store and message broker.
- Running a Zipkin container instance for observability.
- Creating a default components folder with component definitions for the above.
- Running a Dapr placement service container instance for local actor support.
{{% alert title="Docker" color="primary" %}} The recommended development environment requires Docker. While you can [initialize Dapr without a dependency on Docker]({{}})), the next steps in this guide assume the recommended Docker development environment.
You can also install Podman in place of Docker. Read more about [initializing Dapr using Podman]({{}}). {{% /alert %}}
Step 1: Open an elevated terminal
{{< tabs "Linux/MacOS" "Windows">}}
{{% codetab %}}
You will need to use sudo
for this quickstart if:
- You run your Docker commands with
sudo
, or - The install path is
/usr/local/bin
(default install path).
{{% /codetab %}}
{{% codetab %}}
Run Windows Terminal or command prompt as administrator.
- Right click on the Windows Terminal or command prompt icon.
- Select Run as administrator.
{{% /codetab %}}
{{< /tabs >}}
Step 2: Run the init CLI command
Install the latest Dapr runtime binaries:
dapr init
Step 3: Verify Dapr version
dapr --version
Output:
CLI version: {{% dapr-latest-version cli="true" %}}
Runtime version: {{% dapr-latest-version long="true" %}}
Step 4: Verify containers are running
As mentioned earlier, the dapr init
command launches several containers that will help you get started with Dapr. Verify you have container instances with daprio/dapr
, openzipkin/zipkin
, and redis
images running:
docker ps
Output:

Step 5: Verify components directory has been initialized
On dapr init
, the CLI also creates a default components folder that contains several YAML files with definitions for a state store, Pub/sub, and Zipkin. The Dapr sidecar will read these components and use:
- The Redis container for state management and messaging.
- The Zipkin container for collecting traces.
Verify by opening your components directory:
- On Windows, under
%UserProfile%\.dapr
- On Linux/MacOS, under
~/.dapr
{{< tabs "Linux/MacOS" "Windows">}}
{{% codetab %}}
ls $HOME/.dapr
Output:
bin components config.yaml
{{% /codetab %}}
{{% codetab %}}
explorer "%USERPROFILE%\.dapr\"
Result:

{{% /codetab %}}
{{< /tabs >}}
{{< button text="Next step: Use the Dapr API >>" page="getting-started/get-started-api.md" >}}