How-To: Install Dapr into your local environment

Prerequisites

• Install Dapr CLI
• Install Docker Desktop
  • Windows users ensure that Docker Desktop For Windows uses Linux containers.

Initialize Dapr using the CLI

This step installs the latest Dapr Docker containers and setup a developer environment to help you get started easily with Dapr.

• In Linux/MacOS Dapr is initialized with default components and files in $HOME/.dapr.
• For Windows Dapr is initialized to %USERPROFILE%\.dapr\

1. Ensure you are in an elevated terminal:

   • Linux/MacOS: if you run your docker commands with sudo or the install path is /usr/local/bin(default install path), you need to use sudo
   • Windows: make sure that you run the command prompt terminal in administrator mode (right click, run as administrator)

2. Run dapr init --runtime-version 1.0.0-rc.1

   You can install or upgrade to a specific version of the Dapr runtime using dapr init --runtime-version. You can find the list of versions in Dapr Release

   $ dapr init --runtime-version 1.0.0-rc.1
   ⌛  Making the jump to hyperspace...
   Downloading binaries and setting up components
   ✅  Success! Dapr is up and running. To get started, go here: https://aka.ms/dapr-getting-started
   

3. Verify Dapr containers are running

   From a command prompt run the docker ps command and check that the daprio/dapr, openzipkin/zipkin, and redis container images are running:

   $ docker ps
   CONTAINER ID        IMAGE               COMMAND                  CREATED              STATUS              PORTS                              NAMES
   67bc611a118c        daprio/dapr         "./placement"            About a minute ago   Up About a minute   0.0.0.0:6050->50005/tcp            dapr_placement
   855f87d10249        openzipkin/zipkin   "/busybox/sh run.sh"     About a minute ago   Up About a minute   9410/tcp, 0.0.0.0:9411->9411/tcp   dapr_zipkin
   71cccdce0e8f        redis               "docker-entrypoint.s…"   About a minute ago   Up About a minute   0.0.0.0:6379->6379/tcp             dapr_redis
   

4. Verify Dapr directory has been initialized

   • Linux/MacOS: Run ls $HOME/.dapr

     $ ls $HOME/.dapr
     bin  components  config.yaml
     

   • Windows: Open %USERPROFILE%\.dapr\ in file explorer

     

Uninstall Dapr in self-hosted mode

This cli command removes the placement Dapr container:

$ dapr uninstall

$ dapr uninstall --all

Next steps

• Setup a state store and pub/sub message broker