Skip to main content
Configure Strix using environment variables or a config file.

LLM Configuration

string
required
Model name in LiteLLM format (e.g., openrouter/z-ai/glm-5.3, openai/gpt-6.1-sol).
string
API key for your LLM provider. Not required for local models or cloud provider auth (Vertex AI, AWS Bedrock).
string
Custom API base URL. Also accepts OPENAI_API_BASE, LITELLM_BASE_URL, or OLLAMA_API_BASE.
number
Price per 1M input tokens in USD for STRIX_LLM. Use it for gateway or self-hosted model ids that LiteLLM can’t price.
number
Price per 1M output tokens in USD for STRIX_LLM.
number
Price per 1M cached input tokens in USD for STRIX_LLM. If unset, cached tokens use the input price.
Setting any of these prices replaces the provider-reported and LiteLLM cost for STRIX_LLM in reports and --max-budget. An unset input or output price counts as 0, so set both. A separate STRIX_DEDUPE_MODEL keeps its LiteLLM price.
string
Select the OpenAI API path for the model: responses or chat_completions. By default the model decides: Responses when LiteLLM’s model catalog lists /v1/responses for it (e.g. gpt-5), chat completions otherwise. A custom LLM_API_BASE does not change this, so set STRIX_API_TYPE=chat_completions when your gateway only serves chat completions. Applies to bare and openai/ model names. Also accepts STRIX_FORCE_API.
string
Extra HTTP headers sent on every LLM request, as a JSON object (e.g. {"X-Feature-Key":"value","X-Tenant":"acme"}). Useful for OpenAI-compatible gateways that require attribution or routing headers in addition to the bearer token. The bearer token itself still comes from LLM_API_KEY. Applies to both the LiteLLM and native OpenAI routing paths.
string
Extra fields merged into the JSON body of every request to the main model, as a JSON object (e.g. {"service_tier":"flex","safety_identifier":"9f86d081..."}). Use it for provider parameters Strix doesn’t expose, such as OpenAI’s service_tier or safety_identifier. Applies to both the LiteLLM and native OpenAI routing paths. Fields are not validated, so the provider or gateway must accept them; unknown fields are usually rejected. Extra fields can override fields Strix sends and break requests, so don’t set request-shaping fields such as model, messages, input, tools or stream, and use STRIX_REASONING_EFFORT rather than reasoning_effort.
integer
default:"300"
Request timeout in seconds for LLM calls.
integer
default:"30"
Seconds the startup connection check waits for the model to answer before failing with LLM CONNECTION FAILED. Scan requests use LLM_TIMEOUT.
integer
default:"5"
Maximum number of retries for LLM API calls on transient failures.
string
default:"high"
Control thinking effort for reasoning models. Valid values: none, minimal, low, medium, high, xhigh, max. Defaults to medium for quick scan mode.
integer
default:"30"
Timeout in seconds for memory compression operations (context summarization).
boolean
default:"false"
Send a per-agent session_id on OpenRouter requests, so each agent’s calls stay on one upstream provider and its prompt cache carries over between turns. When unset, OpenRouter routes every request freely.
integer
default:"128"
Token block size that providers cache prompts in. A turn counts as a cache miss in the run report only when the cached tokens fall at least this many tokens short of the previous prompt and the prompt did not shrink. Lower it for providers with smaller blocks (DeepSeek and GLM use 64; vLLM defaults to 16).

Dedicated deduplication model

Finding deduplication is a cheap, structured classification task. By default it runs on the main model, but you can route it to a smaller/cheaper model without affecting the agents that do the actual testing.
string
Model used to judge whether a candidate finding duplicates an existing report. Falls back to STRIX_LLM when unset.
string
Optional provider key for the deduplication model.
string
Optional custom API base URL for the deduplication model. Use when the dedupe model runs on a different endpoint than the main model.
string
Optional JSON object of extra HTTP headers sent on every deduplication-model request, e.g. {"X-Feature-Key":"value"}. A dedicated dedupe model never inherits LLM_EXTRA_HEADERS; set this when its endpoint needs custom headers.
string
Optional JSON object of extra request-body fields sent on every deduplication-model request. A dedicated dedupe model never inherits LLM_EXTRA_BODY; set this when its endpoint needs them too.
string
Reasoning effort for the deduplication model. Defaults to the model’s own baseline when unset.

Optional Features

string
API key for Perplexity AI. Enables real-time web search during scans for OSINT and vulnerability research.
string
API key for Exa. Enables real-time web search through the Exa /search endpoint. Exa also powers the web_get_contents tool, which fetches the full text of a page through the Exa /contents endpoint. This is the preferred web search provider.
string
default:"auto"
Web search provider: auto, perplexity, or exa. With auto, Strix uses Exa when EXA_API_KEY is set, and Perplexity otherwise. Set an explicit provider to pin one when you configure both keys.
string
default:"auto"
Exa search mode: auto, fast, instant, deep-lite, deep, or deep-reasoning. Lower modes return results faster. Higher modes plan across more steps and take more time. This setting applies only to the Exa provider.
integer
default:"5"
Number of Exa results to return, from 1 to 100. Each result includes a title, a URL, and a short security-focused summary. To read a full page, the agent calls web_get_contents with the result URL. This setting applies only to the Exa provider.
string
Postman API key (PMAK-…). Enables fetching Postman collections by id as a target (postman://<collection-uid>), and Postman environments (postman://<collection-uid>?env=<environment-uid>) to resolve collection variables. Not needed when passing a local collection export file.
string
default:"1"
Telemetry toggle. Set to 0, false, no, or off to disable telemetry (PostHog, Scarf, OTEL).
boolean
default:"false"
Record every LLM request’s and tool call’s timing in run.json, under llm_requests and tool_calls. Adds about 0.5 MB to a typical scan’s run.json.
string
OTLP/Traceloop base URL for remote OpenTelemetry export. If unset, Strix keeps traces local only.
string
API key used for remote trace export. Remote export is enabled only when both TRACELOOP_BASE_URL and TRACELOOP_API_KEY are set.
string
Optional custom OTEL headers (JSON object or key=value,key2=value2). Useful for Langfuse or custom/self-hosted OTLP gateways.
When remote OTEL vars are not set, Strix still writes complete run telemetry locally to:
When remote vars are set, Strix dual-writes telemetry to both local JSONL and the remote OTEL endpoint.

Docker Configuration

string
default:"ghcr.io/usestrix/strix-sandbox:1.4.1"
Docker image to use for the sandbox container.
string
Docker daemon address, for example unix:///var/run/docker.sock or tcp://10.0.0.5:2375. When not set, Strix connects to the same daemon as the docker CLI: the current docker context (docker context use), then the default socket. Docker Desktop, OrbStack and Colima register their sockets as contexts, so no extra configuration is needed for them.
string
default:"docker"
Runtime backend for the sandbox environment.

Sandbox Configuration

integer
default:"120"
Maximum execution time in seconds for sandbox operations.
integer
default:"10"
Timeout in seconds for connecting to the sandbox container.

Config File

Strix stores configuration in ~/.strix/cli-config.json. You can also specify a custom config file:
Config file format:

Example Setup