mirror of
https://github.com/usestrix/strix.git
synced 2026-10-01 02:03:55 +00:00
fb5fcb17ad
Selectable via STRIX_RUNTIME_BACKEND=podman, with auto-detection of Podman sockets across Linux (rootless/rootful) and macOS (applehv/libkrun podman machine), correct host-gateway hostname (host.containers.internal), and multi-layer socket fallthrough: STRIX_RUNTIME_SOCKET -> DOCKER_HOST -> per-backend auto-detection -> docker.from_env() default. Adds backend-aware CLI/connection checks (check_docker_installed, check_docker_connection) and 28 unit tests covering backend registry, socket candidate generation, podman machine inspect JSON parsing, and socket fallthrough. Adds make test target wired into make check-all. Closes #106
79 lines
1.6 KiB
Text
79 lines
1.6 KiB
Text
---
|
|
title: "Quick Start"
|
|
description: "Install Strix and run your first security scan"
|
|
---
|
|
|
|
## Prerequisites
|
|
|
|
- Docker or Podman (running)
|
|
- An LLM API key from any [supported provider](/llm-providers/overview) (OpenAI, Anthropic, Google, etc.)
|
|
|
|
## Installation
|
|
|
|
<Tabs>
|
|
<Tab title="curl">
|
|
```bash
|
|
curl -sSL https://strix.ai/install | bash
|
|
```
|
|
</Tab>
|
|
<Tab title="pipx">
|
|
```bash
|
|
pipx install strix-agent
|
|
```
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
## Configuration
|
|
|
|
Set your LLM provider:
|
|
|
|
```bash
|
|
export STRIX_LLM="openrouter/z-ai/glm-5.3"
|
|
export LLM_API_KEY="your-api-key"
|
|
```
|
|
|
|
<Tip>
|
|
For best results, use `openrouter/z-ai/glm-5.3` (the default pick), `openai/gpt-5.4`, `anthropic/claude-opus-4-6`, or `openai/gpt-5.2`.
|
|
</Tip>
|
|
|
|
## Run Your First Scan
|
|
|
|
```bash
|
|
strix --target ./your-app
|
|
```
|
|
|
|
<Note>
|
|
First run pulls the Docker sandbox image automatically. Results are saved to `strix_runs/<run-name>`.
|
|
</Note>
|
|
|
|
## Target Types
|
|
|
|
Strix accepts multiple target types:
|
|
|
|
```bash
|
|
# Local codebase
|
|
strix --target ./app-directory
|
|
|
|
# GitHub repository
|
|
strix --target https://github.com/org/repo
|
|
|
|
# Live web application
|
|
strix --target https://your-app.com
|
|
|
|
# Multiple targets (white-box testing)
|
|
strix -t https://github.com/org/repo -t https://your-app.com
|
|
|
|
# Targets from a file, one target per non-empty, non-comment line
|
|
strix --target-list ./targets.txt
|
|
```
|
|
|
|
## Next Steps
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="CLI Options" icon="terminal" href="/usage/cli">
|
|
Explore all command-line options.
|
|
</Card>
|
|
<Card title="Scan Modes" icon="gauge" href="/usage/scan-modes">
|
|
Choose the right scan depth.
|
|
</Card>
|
|
</CardGroup>
|