DocumentationInstall the macOS agent

Install the macOS agent

Install the macOS agent

Status of the macOS port: milestone M0, no deliverable. Planned components, architecture choices, Apple signing and notarization path.

Why a dedicated port

macOS offers no WFP driver or minifilter equivalent to Windows. Transparent TCP interception uses an NETransparentProxyProvider as a System Extension. Agent file and process protection uses a second Endpoint Security System Extension. Both extensions require entitlements granted by Apple on request.

Feature parity with Windows is the goal. The UI is rewritten in SwiftUI for native integration (VoiceOver, menu bar, System Settings) and to avoid licensing constraints of ported toolkits.

Planned components

Target macOS architecture
ComponentNameRole
Servicemacguard-svcLaunchDaemon as root. TLS proxy, detection, policies, storage, telemetry, updates.
Network extensionMacGuardNetExtSystem Extension NETransparentProxyProvider. Redirects outbound TCP to the service, blocks UDP 443.
Protection extensionMacGuardEndpointExtSystem Extension Endpoint Security. Protects agent files and processes.
Menu agentMacGuard.appLaunchAgent, user session. Menu bar icon (NSStatusItem), IPC relay.
UIMacGuard.appSwiftUI windows. Decision, dashboard, administration (Authorization Services).
CLI toolmacguard-adminCounterpart of dlpia-admin and linguard-admin.

Planned delivery format

  • Universal package: one .pkg for both Apple Silicon and Intel (arm64 and x86_64).
  • Signing: Developer ID certificate (Apple).
  • Notarization: Apple notarization with notarytool and stapling via stapler.
  • Minimum OS: macOS 14 (Sonoma) or newer.
  • Fleet deployment: Jamf, Intune, Kandji, Mosyle. Configuration profile .mobileconfig for System Extension approval and the local root.

Required Apple entitlements

  • Network Extension: granted on request, typical delay of a few weeks.
  • Endpoint Security: granted on request, typical delay longer.
  • System Extension install: required to install both extensions.

Next steps

  1. Open the publisher Apple Developer account.
  2. Request and secure the Network Extension, Endpoint Security and System Extension install entitlements.
  3. Milestone M1: Swift scaffolding, workspace, GitLab CI with macOS runners.
  4. Milestones M2 to M9: platform, interception, darwin detection (NERLite, OCR via Vision), SwiftUI UI, self-protection.
  5. Milestone M10: signed and notarized .pkg, MDM profiles, updates.

To express a macOS interest and influence rollout priority, use the Contact page. Prospect feedback drives the priority of milestones M1 to M10.