RetrySight Cloud staging is live.

Open Cloud
RetrySight
Download Lite Start trial
Documentation menu
Docs home

Docs enterprise

Install the fleet agent

Install unsigned RetrySight Enterprise fleet agent packages on macOS, Windows, and Linux — Gatekeeper and SmartScreen workarounds.

On this page
  1. Before you start
  2. macOS (.pkg)
  3. Windows (.msi)
  4. Linux (.deb)
  5. Portable JAR
  6. Configure the agent
  7. Need a package?

Current macOS and Windows agent packages are not Apple-notarized and not Microsoft Authenticode-signed. Your OS will warn on first install — approve the package explicitly, then point the agent at your manager.

Native installers register the agent as an OS service so it starts at login and comes back after reboot.

Before you start

  • Download the installer for your OS from the Enterprise Core download page (or your licensed tier channel)
  • Have your manager URL and agent API key ready
  • Expect OS security prompts — that is expected for unsigned packages

macOS (.pkg)

Download the package that matches the Mac: Apple Silicon (RetrySightAgent-*-arm64.pkg) or Intel (RetrySightAgent-*-x64.pkg). There is no universal installer. Gatekeeper blocks unsigned packages by default.

  1. Download the arm64 or x64 .pkg for this machine.
  2. Right-click the package → Open (do not double-click), then confirm Open in the dialog.
  3. If macOS still blocks it: System Settings → Privacy & Security, find the blocked package message, and choose Open Anyway.
  4. Complete the installer — the package registers LaunchAgent com.retrysight.agent with RunAtLoad and KeepAlive.
  5. Grant Full Disk Access to RetrySightAgent if the agent warns that IDE log folders are unreadable.

Windows (.msi)

SmartScreen warns on unsigned MSI files.

  1. Download RetrySightAgent-*.msi.
  2. If SmartScreen appears, choose More info → Run anyway.
  3. Approve the UAC prompt if shown.
  4. After install, run register-autostart.ps1 once (from an elevated PowerShell if your policy requires it) to create the RetrySightAgent AtLogOn task.

Linux (.deb)

  1. Download retrysight-agent_*_amd64.deb.
  2. Install with sudo dpkg -i retrysight-agent_*_amd64.deb (or your package manager equivalent).
  3. The package enables user systemd unit retrysight-agent.service (systemctl --global enable).

Portable JAR

Use infra/scripts/install-agent-service.sh (macOS/Linux) or infra/windows/install-agent-service.ps1 for the same auto-start behavior as native packages.

Configure the agent

Set manager URL and API key in ~/.agent-retry/config.yaml (or via retrysight-agent configure if the CLI is on your PATH). Confirm a heartbeat on the manager Agents page.

Full YAML: agent config.

Need a package?

Start with free Enterprise Core downloads, or see all Enterprise tiers.