---
updatedAt: 2026-10-21T06:35:39.000Z
agentTools:
  projectIndex: https://docs.brightsec.com/llms.txt
---

# Run STAR Locally

STAR is designed to run in CI — see [Running STAR in CI](https://docs.brightsec.com/docs/star-installation#running-star-in-ci) for the supported setup. The same binary can also be run directly on a machine, which is useful for debugging a run outside of CI.

The download links, per-platform binary names, and the exact download/run commands are maintained in the [`bright-agent-dist` README](https://github.com/BrightSec/bright-agent-dist#readme) — follow it rather than copying commands from here, so you always get the current instructions.

## What a local run does

1. **Download the binary** for your platform from the [releases page](https://github.com/BrightSec/bright-agent-dist/releases/latest) and verify its `.sha256` checksum, per the [README](https://github.com/BrightSec/bright-agent-dist#download).
2. **Run it from inside a checkout** of the repository you want to scan. STAR runs against the working copy you already have on disk — it does **not** clone. `LOCAL_REPO_PATH` defaults to the current directory.
3. STAR detects the tech stack, builds and starts the app, scans it, and opens (or updates) a pull request with any verified fixes.

The minimum environment is `BRIGHT_TOKEN`, `REPO_ACCESS_TOKEN`, and credentials for your selected inference provider. Most providers use `INFERENCE_TOKEN` or `OPENAI_API_KEY`; AWS Bedrock can instead use supported AWS credentials from an IAM role, EC2 instance or ECS task role, profile, or OIDC federation. See [Configuration](https://docs.brightsec.com/docs/star-installation#configuration), [AWS Bedrock Authentication with IAM and OIDC](https://docs.brightsec.com/docs/star-bedrock-iam), and [Prerequisites](https://docs.brightsec.com/docs/star-prerequisites).

The diagnostic log is written to `~/.bright-agent/logs/run-<timestamp>.log`; set `BRIGHT_DEBUG=1` to also mirror it to the console. See [Logging & Troubleshooting](https://docs.brightsec.com/docs/star-logging-and-troubleshooting).