Skip to main content

Scanning

Running a Scan​

  1. Navigate to Scans in the sidebar
  2. Click New Scan
  3. Configure:
    • Name: a descriptive name for this scan run
    • Target: which AI model to scan
    • Probes: select probe families to include (or select all)
    • Output Server: optional SIEM destination for results
  4. Click Run Scan

The scan is queued immediately and begins when a worker slot is available. 0DIN Scanner runs up to 5 scans concurrently.

Scheduling Scans​

Scheduled scans run automatically on a recurring basis without manual intervention.

  1. From the scan configuration, enable Schedule
  2. Choose recurrence: daily, weekly, or a custom cron expression
  3. Save, and 0DIN Scanner will run the scan automatically at the configured interval

Scheduled scans use the same probe selection and target configuration as one-off scans. Results are saved as new reports each run, allowing you to track ASR trends over time.

Monitoring Progress​

While a scan runs, the progress view shows:

  • Which probe family is currently executing
  • Number of attempts completed / total
  • Real-time ASR as results come in

You can navigate away; the scan continues in the background. Return to the scan page to check status.

Activity Stream​

Authenticated users see Activity Stream automatically on pending, starting, running, and processing report pages while troubleshooting a scan. Select View activity to expand timeline entries, the raw JSONL tail, and execution logs. Running scans show a database-backed live tail with offset, truncation, and last-updated metadata. Terminal reports can use the optional ?debug=true fallback to show final execution logs. PDF rendering does not include Activity Stream.

Parallel Attempts​

Each probe runs multiple attempts in parallel to improve coverage. The default is 16 parallel attempts.

Adjust this in Settings → Parallel Attempts based on your target's rate limits:

ProviderRecommended Setting
OpenAI5–10
Anthropic3–5
Local models (Ollama)20–50
Rate-limited APIs2–5
tip

If scans are failing with rate limit errors, reduce parallel attempts for that target by setting PARALLEL_ATTEMPTS as a per-target environment variable.

Scan Lifecycle​

  • Queued: waiting for a worker slot
  • Running: probes are executing
  • Completed: all probes finished, report is available
  • Failed: garak encountered an error; check the scan log for details
  • Interrupted: 0DIN Scanner was restarted mid-scan; the scan will be retried automatically

Stopping a Scan​

Running scans cannot be stopped mid-execution in the current release. If you need to cancel a scan, restart the Docker container; the scan will be marked as interrupted and retried.

Report Retention​

Completed reports are retained for 90 days by default. Adjust this with the RETENTION_DAYS environment variable in your .env file. Reports older than the retention period are automatically deleted by a background job.