Skip to content
Patronus Patronus

Installation

Patronus Desktop runs as a local protection app on macOS and Windows. The first launch guides the user through the operating-system approvals Patronus needs before it can observe supported AI traffic.

Requirements

Section titled “Requirements”
  • macOS or Windows with permission to install local system components.
  • The Patronus installer for your operating system.
  • Network access during first setup.
  • Admin approval when the operating system asks for it.

Install On macOS

Section titled “Install On macOS”
  1. Download the macOS DMG from the Patronus download page.
  2. Open the DMG and move Patronus.app into /Applications or ~/Applications.
  3. Start Patronus.app.
  4. Follow the setup screen in Patronus.
  5. Approve the macOS prompts shown during setup.
  6. Start protection from Patronus Desktop.

If macOS asks for Network Extension approval, approve Patronus in System Settings and return to Patronus Desktop.

Install On Windows

Section titled “Install On Windows”
  1. Download the Windows installer from the Patronus download page.
  2. Run the installer and approve the Windows elevation prompt.
  3. Complete the installer. If Windows needs an additional Microsoft WebView component, the installer will guide you through it.
  4. Start Patronus Desktop from the Start Menu.
  5. Follow the setup screen in Patronus.
  6. Start protection from Patronus Desktop.

If Windows requires additional security approval, complete the prompt and return to Patronus Desktop.

Verify Protection

Section titled “Verify Protection”

After setup:

  1. Open Patronus from the tray.
  2. Confirm Patronus shows protection as running.
  3. Send a simple request through a supported AI app, CLI, SDK, or local model endpoint.
  4. Open the activity or audit view and check that the request appears.

Update And Repair

Section titled “Update And Repair”

Patronus may show one of these visible update or recovery states:

  • Update available means a new Patronus version can be installed.
  • Repair required means Patronus needs to restore a local component before protection can start.
  • Restart required means the operating system or Patronus needs a restart before protection continues.

Follow the action shown in Patronus Desktop. If protection does not start after the action, restart Patronus and try again.

Uninstall

Section titled “Uninstall”

Use the standard uninstall flow for your operating system:

  • On macOS, use the Patronus uninstaller if one is included with your installation package.
  • On Windows, uninstall Patronus from Windows Settings or the Start Menu entry provided by the installer.

After uninstalling, restart the device if the operating system asks for it.