The documentation you are viewing is for Dapr v1.7 which is an older version of Dapr. For up-to-date documentation, see the latest version.
init CLI command reference
Description
Install Dapr on supported hosting platforms.
Supported platforms
Usage
dapr init [flags]
Flags
| Name | Environment Variable | Default | Description |
|---|---|---|---|
--dashboard-version |
latest |
The version of the Dapr dashboard to install, for example: 1.0.0 |
|
--enable-ha |
false |
Enable high availability (HA) mode | |
--enable-mtls |
true |
Enable mTLS in your cluster | |
--from-dir |
Path to a local directory containing a downloaded “Dapr Installer Bundle” release which is used to init the airgap environment |
||
--help, -h |
Print this help message | ||
--image-registry |
Pulls container images required by Dapr from the given image registry | ||
--kubernetes, -k |
false |
Deploy Dapr to a Kubernetes cluster | |
--namespace, -n |
dapr-system |
The Kubernetes namespace to install Dapr in | |
--network |
The Docker network on which to install and deploy the Dapr runtime | ||
--runtime-version |
latest |
The version of the Dapr runtime to install, for example: 1.0.0 |
|
--set |
Configure options on the command line to be passed to the Dapr Helm chart and the Kubernetes cluster upon install. Can specify multiple values in a comma-separated list, for example: key1=val1,key2=val2 |
||
--slim, -s |
false |
Exclude placement service, Redis and Zipkin containers from self-hosted installation | |
--timeout |
300 |
The wait timeout for the Kubernetes installation | |
--wait |
false |
Wait for Kubernetes initialization to complete | |
| N/A | DAPR_DEFAULT_IMAGE_REGISTRY | In self hosted mode, it is used to specify the default container registry to pull images from. When its value is set to GHCR or ghcr it pulls the required images from Github container registry. To default to Docker hub as default, just unset this env variable. |
Examples
Self hosted environment
Install Dapr by pulling container images for Placement, Redis and Zipkin. By default these images are pulled from Docker Hub. To switch to Dapr Github container registry as the default registry, set the DAPR_DEFAULT_IMAGE_REGISTRY environment variable value to be GHCR. To switch back to Docker Hub as default registry, unset this environment variable.
dapr init
You can also specify a specific runtime version. Be default, the latest version is used.
dapr init --runtime-version 1.4.0
Dapr can also run Slim self-hosted mode without Docker.
dapr init -s
In an offline or airgap environment, you can download a Dapr Installer Bundle and use this to install Dapr instead of pulling images from the network.
dapr init --from-dir <path-to-installer-bundle-directory>
Dapr can also run in slim self-hosted mode without Docker in an airgap environment.
dapr init -s --from-dir <path-to-installer-bundle-directory>
You can also specify a private registry to pull container images from. These images need to be published to private registries as shown below to enable Dapr CLI to pull them successfully via the dapr init command -
- Dapr runtime container image(dapr) (Used to run Placement) - dapr/dapr:
- Redis container image(rejson) - dapr/3rdparty/rejson
- Zipkin container image(zipkin) - dapr/3rdparty/zipkin
All the required images used by Dapr needs to be under the
daprpath.
The 3rd party images have to be published under
dapr/3rdpartypath.
image-registy uri follows this format -
docker.io/<username>
dapr init --image-registry docker.io/username
This command resolves the complete image URI as shown below -
- Placement container image(dapr) - docker.io/username/dapr/dapr:
- Redis container image(rejson) - docker.io/username/dapr/3rdparty/rejson
- zipkin container image(zipkin) - docker.io/username/dapr/3rdparty/zipkin
Kubernetes environment
dapr init -k
You can wait for the installation to complete its deployment with the --wait flag.
The default timeout is 300s (5 min), but can be customized with the --timeout flag.
dapr init -k --wait --timeout 600
You can also specify a specific runtime version.
dapr init -k --runtime-version 1.4.0
Use the --set flag to configure a set of Helm Chart values during Dapr installation to help set up a Kubernetes cluster.
dapr init -k --set global.tag=1.0.0 --set dapr_operator.logLevel=error
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.