Last reviewed February 25, 2026

Sirius Agent Downloads and Setup

Use this guide to download the Sirius Agent binary for your platform and run it with the correct runtime commands.

Managed Runtime Environment Variables

Use these variables when running the agent in managed mode:

  • SIRIUS_API_KEY: API key used to submit results to the Sirius API
  • SERVER_ADDRESS: Sirius server gRPC address (for example sirius.example.com:50051)

Linux / macOS

export SIRIUS_API_KEY="<your-sirius-api-key>"
export SERVER_ADDRESS="<sirius-host>:50051"
sirius-agent

Windows (PowerShell)

$env:SIRIUS_API_KEY = "<your-sirius-api-key>"
$env:SERVER_ADDRESS = "<sirius-host>:50051"
.\sirius-agent.exe

CLI Mode (Local Execution)

CLI mode can run templates locally without server connectivity.

sirius-agent template list
sirius-agent template run ./templates/builtin/<template>.yaml
sirius-agent template run-all

Validate the Agent Binary

sirius-agent version

If you need older versions or checksums, use the release assets on GitHub or the links in the download page.