Skip to content

Configuration

Requirements: Dapr 1.18+ with mTLS enabled. .NET 10.0 SDK.

The WorkManager and the WorkManager.Runtime read their settings from environment variables and command-line arguments (command line wins). Both share this host setup (HostSetup in Virtufin.WorkManager.Shared).

Both services

Setting Description Default
HttpPort / --http-port HTTP/1.1 port: /health, /healthz, /ready 5001
GrpcPort / --grpc-port gRPC port (HTTP/2, plain text) 5002
Logging:LogLevel:Default / --log-level / -l Minimum log level (Trace … None) Information
VIRTUFIN_API_HOST / VIRTUFIN_API_GRPC_PORT The virtufin API (State, Pubsub, Trigger) localhost / 5002
VIRTUFIN_API_KEY Key sent to the API (it rejects every non-health call once it has keys) none
VIRTUFIN_REGISTRY_USER / VIRTUFIN_REGISTRY_TOKEN The org registry credential (the virtufin named credential, Virtufin.* dependencies) none

WorkManager

Setting Description Default
ALLOWED_CODE_SOURCE_HOSTS (or AllowedCodeSourceHosts) Comma-separated host allow-list for code source URLs; empty allows any host that doesn't resolve to a private address. See Security. empty
RUNTIME_WORKER_POKE_INTERVAL_SECONDS How often running workers' Runtime actors are poked (reactivating a deactivated one). Floored at 30. 60

WorkManager.Runtime

Setting Description Default
DAPR_GRPC_PORT The pod's daprd gRPC port (set by the sidecar injector), for the worker secret store 50001
LIBRARY_UPDATE_POLL_SECONDS How often DotNetDll and C# source workers' Virtufin.* NuGet dependencies, TypeScript workers' @virtufin/* npm packages and wheel workers' virtufin-* PyPI packages are re-checked; a newer release reloads the worker. 0 disables. 300
DOTNET_DEFAULT_NUGET_SOURCE_URL The public NuGet source for third-party worker dependencies nuget.org

Worker secrets have their own settings; see Worker Secrets. WORKER_SECRETS_TTL_SECONDS (default 60) also bounds how stale a worker's IWorkerContext.GetSecretsAsync() can be, so it is how long a rotated Secret takes to reach a reconnecting worker.

Examples

export HttpPort=3000
./Virtufin.WorkManager --grpc-port 3002 --log-level Debug