How-To: Install Dapr into your local environment

Install Dapr in your local environment for testing and self-hosting

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

      Explorer files

Uninstall Dapr in self-hosted mode

This cli command removes the placement Dapr container:

$ dapr uninstall

Next steps