docs/daprdocs/content/en/getting-started/install-dapr-selfhost.md

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`
/getting-started/set-up-dapr/install-dapr/

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:

  1. Running a Redis container instance to be used as a local state store and message broker.
  2. Running a Zipkin container instance for observability.
  3. Creating a default components folder with component definitions for the above.
  4. 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.

  1. Right click on the Windows Terminal or command prompt icon.
  2. 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" >}}