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, anthropic/claude-sonnet-4-5).
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"
Enable/disable anonymous telemetry. Set to 0, false, no, or off to disable.

Docker Configuration

STRIX_IMAGE
string
default:"ghcr.io/usestrix/strix-sandbox:0.1.11"
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",
    "LLM_API_KEY": "sk-...",
    "STRIX_REASONING_EFFORT": "high"
  }
}

Example Setup

# Required
export STRIX_LLM="openai/gpt-5"
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"