OS Manuals

/usr/bin/placement

Dapr Placement control plane service

From dapr-placement-fips-1.16 1.16.21-r4 (enterprise-packages), captured 2026-11-08 by running placement --help (exit 0). permalink

Usage of placement:
      --disseminate-timeout duration    sets the timeout period for dissemination to be delayed after actor membership change
                                        so as to avoid excessive dissemination during multiple pod restarts.
                                        Higher values will reduce the frequency of dissemination, but delay the table dissemination.
                                        Accepts values between 1 and 3 seconds (default 2s)
      --enable-metrics                  Enable prometheus metric (default true)
      --healthz-listen-address string   The listening address for the healthz server
      --healthz-port int                sets the HTTP port for the healthz server (default 8080)
      --id string                       Placement server ID (default "dapr-placement-0")
      --initial-cluster strings         raft cluster peers (default [dapr-placement-0=127.0.0.1:8201])
      --inmem-store-enabled             Enable in-memory log and snapshot store unless --raft-logstore-path is set (default true)
      --keepalive-time duration         sets the interval at which the placement service sends keepalive pings to daprd
                                        on the gRPC stream to check if the connection is still alive.
                                        Lower values will lead to shorter actor rebalancing time in case of pod loss/restart,
                                        but higher network traffic during normal operation.
                                        Accepts values between 1 and 10 seconds (default 2s)
      --keepalive-timeout duration      sets the timeout period for daprd to respond to the placement service's keepalive pings
                                        before the placement service closes the connection.
                                        Lower values will lead to shorter actor rebalancing time in case of pod loss/restart,
                                        but higher network traffic during normal operation.
                                        Accepts values between 1 and 10 seconds (default 3s)
      --listen-address string           The listening address for the placement service
      --log-as-json                     print log as JSON (default false)
      --log-level string                Options are debug, info, warn, error, or fatal (default info) (default "info")
      --max-api-level int               If set to >= 0, causes the reported 'api-level' in the cluster to never exceed this value (default 10)
      --metadata-enabled                Expose the placement tables on the healthz server
      --metrics-listen-address string   The address for the metrics server (default "0.0.0.0")
      --metrics-port string             The port for the metrics server (default "9090")
      --min-api-level int               Enforces a minimum 'api-level' in the cluster
      --mode string                     Runtime mode for Placement (default "standalone")
      --port int                        sets the gRPC port for the placement service (default 50005)
      --raft-logstore-path string       raft log store path.
      --replicationFactor int           sets the replication factor for actor distribution on virtual nodes (default 100)
      --sentry-address string           Address of the Sentry service (default "dapr-sentry.default.svc:443")
      --tls-enabled                     Should TLS be enabled for the placement gRPC server
      --trust-anchors-file string       Filepath to the trust anchors for the Dapr control plane (default "/var/run/secrets/dapr.io/tls/ca.crt")
      --trust-domain string             Trust domain for the Dapr control plane (default "localhost")
Options (25)
OptionDescriptionSource
--disseminate-timeout durationsets the timeout period for dissemination to be delayed after actor membership change so as to avoid excessive dissemination during multiple pod restarts.help
--enable-metricsEnable prometheus metric (default true)help
--healthz-listen-address stringThe listening address for the healthz serverhelp
--healthz-port intsets the HTTP port for the healthz server (default 8080)help
--id stringPlacement server ID (default "dapr-placement-0")help
--initial-cluster stringsraft cluster peers (default [dapr-placement-0=127.0.0.1:8201])help
--inmem-store-enabledEnable in-memory log and snapshot store unless --raft-logstore-path is set (default true)help
--keepalive-time durationsets the interval at which the placement service sends keepalive pings to daprd on the gRPC stream to check if the connection is still alive.help
--keepalive-timeout durationsets the timeout period for daprd to respond to the placement service's keepalive pings before the placement service closes the connection.help
--listen-address stringThe listening address for the placement servicehelp
--log-as-jsonprint log as JSON (default false)help
--log-level stringOptions are debug, info, warn, error, or fatal (default info) (default "info")help
--max-api-level intIf set to >= 0, causes the reported 'api-level' in the cluster to never exceed this value (default 10)help
--metadata-enabledExpose the placement tables on the healthz serverhelp
--metrics-listen-address stringThe address for the metrics server (default "0.0.0.0")help
--metrics-port stringThe port for the metrics server (default "9090")help
--min-api-level intEnforces a minimum 'api-level' in the clusterhelp
--mode stringRuntime mode for Placement (default "standalone")help
--port intsets the gRPC port for the placement service (default 50005)help
--raft-logstore-path stringraft log store path.help
--replicationFactor intsets the replication factor for actor distribution on virtual nodes (default 100)help
--sentry-address stringAddress of the Sentry service (default "dapr-sentry.default.svc:443")help
--tls-enabledShould TLS be enabled for the placement gRPC serverhelp
--trust-anchors-file stringFilepath to the trust anchors for the Dapr control plane (default "/var/run/secrets/dapr.io/tls/ca.crt")help
--trust-domain stringTrust domain for the Dapr control plane (default "localhost")help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.