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

​
LLM Configuration

​
STRIX_LLM
string
required
Model name in LiteLLM format (e.g., openai/gpt-5.4, anthropic/claude-sonnet-4-6).
​
LLM_API_KEY
string
API key for your LLM provider. Not required for local models or cloud provider auth (Vertex AI, AWS Bedrock).
​
LLM_API_BASE
string
Custom API base URL. Also accepts OPENAI_API_BASE, LITELLM_BASE_URL, or OLLAMA_API_BASE.
​
LLM_TIMEOUT
integer
default:"300"
Request timeout in seconds for LLM calls.
​
STRIX_LLM_MAX_RETRIES
integer
default:"5"
Maximum number of retries for LLM API calls on transient failures.
​
STRIX_REASONING_EFFORT
string
default:"high"
Control thinking effort for reasoning models. Valid values: none, minimal, low, medium, high, xhigh. Defaults to medium for quick scan mode.
​
STRIX_MEMORY_COMPRESSOR_TIMEOUT
integer
default:"30"
Timeout in seconds for memory compression operations (context summarization).

​
Optional Features

​
PERPLEXITY_API_KEY
string
API key for Perplexity AI. Enables real-time web search during scans for OSINT and vulnerability research.
​
STRIX_DISABLE_BROWSER
boolean
default:"false"
Disable browser automation tools.
​
STRIX_TELEMETRY
string
default:"1"
Global telemetry default toggle. Set to 0, false, no, or off to disable both PostHog and OTEL unless overridden by per-channel flags below.
​
STRIX_OTEL_TELEMETRY
string
Enable/disable OpenTelemetry run observability independently. When unset, falls back to STRIX_TELEMETRY.
​
STRIX_POSTHOG_TELEMETRY
string
Enable/disable PostHog product telemetry independently. When unset, falls back to STRIX_TELEMETRY.
​
TRACELOOP_BASE_URL
string
OTLP/Traceloop base URL for remote OpenTelemetry export. If unset, Strix keeps traces local only.
​
TRACELOOP_API_KEY
string
API key used for remote trace export. Remote export is enabled only when both TRACELOOP_BASE_URL and TRACELOOP_API_KEY are set.
​
TRACELOOP_HEADERS
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: 
strix_runs/<run_name>/events.jsonl
When remote vars are set, Strix dual-writes telemetry to both local JSONL and the remote OTEL endpoint.

​
Docker Configuration

​
STRIX_IMAGE
string
default:"ghcr.io/usestrix/strix-sandbox:0.1.13"
Docker image to use for the sandbox container.
​
DOCKER_HOST
string
Docker daemon socket path. Use for remote Docker hosts or custom configurations.
​
STRIX_RUNTIME_BACKEND
string
default:"docker"
Runtime backend for the sandbox environment.

​
Sandbox Configuration

​
STRIX_SANDBOX_EXECUTION_TIMEOUT
integer
default:"120"
Maximum execution time in seconds for sandbox operations.
​
STRIX_SANDBOX_CONNECT_TIMEOUT
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: 
strix --target ./app --config /path/to/config.json
Config file format: 
{
  "env": {
    "STRIX_LLM": "openai/gpt-5.4",
    "LLM_API_KEY": "sk-...",
    "STRIX_REASONING_EFFORT": "high"
  }
}

​
Example Setup

# Required
export STRIX_LLM="openai/gpt-5.4"
export LLM_API_KEY="sk-..."

# Optional: Enable web search
export PERPLEXITY_API_KEY="pplx-..."

# Optional: Custom timeouts
export LLM_TIMEOUT="600"
export STRIX_SANDBOX_EXECUTION_TIMEOUT="300"