Platform scope
Mac update reporting begins with release 0.9.3. The Swift collector and AppKit companion require no Python or Homebrew runtime. The package contains Apple silicon and Intel binaries with a macOS 13 deployment target. Runtime acceptance was on Apple silicon running macOS 27.2.1; Intel and older macOS versions remain unverified. A deployment target is not a support guarantee.
This development package is not Developer ID signed or notarized. Its local ad-hoc signatures and transfer checks do not establish production signing. Do not globally disable Gatekeeper or change system certificate trust to resolve an installation error.
Install and enroll
Installation is available only through your existing private deployment administrator. Public downloads and enrollment are closed.
Open the application's /downloads/macos/ page and use its current verified install command. Enter your administrator password only in the local Terminal prompt. In the portal, create a macOS device and obtain its one-use code.
Open Fleet Monitor (the current installed app name) from Applications and choose Setup / enroll. Paste the code at the hidden Terminal prompt. Setup waits for a server-confirmed check-in. Confirm Connected and recent readings in the portal. CPU needs a second sample after startup.
Read local status
'/Library/Application Support/FleetMonitor/current/fleet-monitor-agent' version
'/Library/Application Support/FleetMonitor/current/fleet-monitor-agent' status
'/Library/Application Support/FleetMonitor/current/fleet-monitor-agent' update --check
These commands read version, connection status and update availability. They do not install a release. The protected path contains spaces, so retain the quotes.
Menu bar behavior
Show status opens the connection window. Open Fleet Monitor opens the configured application; ordinary browser sign-in still applies. Copy status copies visible connection and version text without the credential. Closing the window or quitting the app does not stop the background collector.
The login preference controls the menu bar app for that user. Background monitoring starts at boot independently. A Mac asleep or powered off cannot report, and the agent does not prevent sleep. Use an appropriate offline notification policy for laptops.
Agent updates from the application
Development releases from 0.10.0 add a separate root LaunchDaemon for agent-update requests from the signed-in application. The ordinary collector keeps its restricted account. Local helper setup and actual application-requested installation have recorded acceptance on the tested platform. Helper startup after reboot and broader lifecycle checks remain separate; this is lab evidence, not production readiness. See agent-update setup and progress.
Stopping the collector does not disable the separate updater. Use the local disable controls if that helper should not poll. It accepts only the configured server's agent-release requests; it does not install OS patches or run arbitrary scripts. Follow the current download page rather than treating an older documented capability version as the latest package.
Updates and remaining checks
Use Check for updates → Update agent for a newer release, then quit and reopen the companion. The local administrator flow verifies the package and is designed to preserve identity. Initial install, one actual menu-bar upgrade and reboot were accepted. Quiet startup after a real login, intentionally stopped-state upgrade, failed-start rollback and uninstall still require manual acceptance.
macOS reports Apple Software Update availability, but its current reboot requirement stays Unknown. Selected service monitoring is not available on macOS. Resource values use the agent's platform accounting and need not exactly match Activity Monitor categories.
References: Apple launchd jobs, SMAppService.
Remove or retire a device
Follow the platform-specific uninstall guide. Ordinary removal retains enrollment for reinstallation; revoke the device separately in the application when retiring it.