Environment Variables
Every environment variable read by the QueryPilot binaries, with precedence rules.
Overview
This page lists every environment variable read by the QueryPilot binaries: the Router (binary querypilot) and the standalone Accelerator (binary querypilot-accelerator).
For variables that mirror a CLI flag, precedence is:
CLI flag, then environment variable, then config file or built-in default.
The environment variable applies only when the corresponding flag is absent from the command line.
Router
QUERYPILOT_CONFIG
Path to the Router config file. Mirrors -c, --config. When unset, the Router reads querypilot.toml from the current directory. See Router configuration.
QUERYPILOT_LOG_LEVEL
Override the Router log level. Mirrors -l, --log-level and overrides logging.level from the config file. Unlike the config key, it accepts full tracing filter directives, so both debug and sqp_core=debug,info are valid.
QUERYPILOT_LOG_LEVEL=debug querypilotAccelerator (standalone)
QUERYPILOT_ACCELERATOR_ALLOW_INSECURE_HTTP
When set to 1, waives the requirement that a non-loopback sqp_api_url use https plus an API token. Read by the standalone querypilot-accelerator binary only.
This variable exists for test and development fixtures only, so containerized end-to-end tests can reach the Router admin API over plain HTTP across a Docker network. Setting it in production sends the Accelerator's API token and cache-management traffic unencrypted to a non-loopback host. Use https and an API token instead.
All binaries
NO_COLOR
When set to any value, disables ANSI color in log output.
RUST_LOG is not read
querypilot does not read RUST_LOG. It builds its log filter exclusively from the configured level: the config file's logging.level, the --log-level flag, or the QUERYPILOT_LOG_LEVEL variable above. Exporting RUST_LOG=debug has no effect.
The standalone querypilot-accelerator binary reads no logging environment variable at all; its verbosity is the log_verbosity key in its config file.
Values preset by the shipped containers
The Docker images and deployment manifests preset three of the variables above; see Deployment for the full container conventions.
| Variable | Value in shipped containers |
|---|---|
QUERYPILOT_CONFIG | /etc/sqp/querypilot.toml |