Environment Variables
Common
| Variable | Type | Default | Usage |
|---|---|---|---|
| QALITA_HOME | string (path) | ~/.qalita | Worker data directory (.worker, .env-*, sources-conf.yaml, jobs/, logs). Honored by CLI ≥ 2.18.2. In Docker it is a path inside the container (default /home/qalita/.qalita) — never the host path of your volume. |
| REQUESTS_CA_BUNDLE | string (path) | none | PEM bundle (root + intermediates) used to validate the platform's HTTPS certificate for REST requests. Required with a private PKI — requests does not read the OS trust store. |
| GRPC_DEFAULT_SSL_ROOTS_FILE_PATH | string (path) | none | Same PEM bundle, for the gRPC channel. Required with a private PKI — gRPC ships its own roots and ignores the OS trust store. |
| SKIP_SSL_VERIFY | boolean | false | Bypass certificate validation for REST requests only (never gRPC). Diagnostic use only — with a private PKI, prefer the two CA variables above. |
Pack
| Variable | Type | Default | Usage |
|---|---|---|---|
| QALITA_PACK_NAME | string | none | Name of the pack to execute/push |
Source
| Variable | Type | Default | Usage |
|---|---|---|---|
| QALITA_SKIP_VALIDATE | boolean | false | Skip source validation before publishing |
Worker
| Variable | Type | Default | Usage |
|---|---|---|---|
| QALITA_WORKER_NAME | string | none | Worker name (required) |
| QALITA_WORKER_MODE | string (job/worker) | none | Worker execution mode (required) |
| QALITA_WORKER_ENDPOINT | string (URL) | none | Platform backend API URL (required) |
| QALITA_WORKER_TOKEN | string | none | API token provided by the platform (required) |
| QALITA_WORKER_GRPC | boolean | true | Use gRPC for real-time job dispatch in worker mode. Set to false to fall back to REST polling. |
| QALITA_GRPC_ENDPOINT | string (host:port or URL) | auto-derived | Explicit gRPC endpoint override, e.g. qalita-backend-service:50051 or grpcs://grpc.example.com:443. By default the gRPC target is derived from QALITA_WORKER_ENDPOINT. Required for Kubernetes intra-cluster setups where the gRPC port (50051) is exposed on the same Service as the REST API. See gRPC endpoint resolution. |
Jobs
| Variable | Type | Default | Usage |
|---|---|---|---|
| QALITA_WORKER_JOB_SOURCE | number (ID) | none | Source ID for a job |
| QALITA_WORKER_JOB_SOURCE_VERSION | number (ID) | latest | Source version to use |
| QALITA_WORKER_JOB_PACK | number (ID) | none | Pack ID for a job |
| QALITA_WORKER_JOB_PACK_VERSION | number (ID) | latest | Pack version to use |
UI
| Variable | Type | Default | Usage |
|---|---|---|---|
| QALITA_WORKER_UI | boolean | false | Enable local web UI for the CLI |
| QALITA_WORKER_UI_PORT | number | 7070 | Local UI port |
| QALITA_WORKER_UI_HOST | string (host) | localhost | Local UI listening interface |
Worker Polling
| Variable | Type | Default | Usage |
|---|---|---|---|
| WORKER_POLLING_INTERVAL | number (seconds) | 1 | Job polling interval in worker mode |