Help Center / Data connectors

The Edventory Agent for Macs

Macs outside your MDM (a lab iMac, a donated MacBook, an office Mac mini) can inventory themselves with the Mac version of the Edventory Agent. It reports the same facts as the Windows agent, plus FileVault status and battery wear on laptops, at every startup and once a day.

Use your agent connector

Macs use the same Edventory Agent connector and enrollment key as Windows PCs (Settings → Connectors). Open its Install & devices panel for the Mac instructions, already filled in with your key.

Install on each Mac

Copy the one-line Terminal command from the panel and run it on the Mac (it asks for an administrator password). It downloads the agent from your Edventory server, enrolls it and checks in. Or download EdventoryAgent.pkg, double-click it, and paste the key when it asks.

Deploying with Jamf, Mosyle or another MDM?

Download the configuration profile from the same panel and push it together with EdventoryAgent.pkg. The profile carries your key, so the package enrolls itself with no prompt on the Mac.

QuestionAnswer
What does it send?Hardware facts only: computer name, model and model identifier, serial number, macOS version, CPU, memory, startup-disk size and free space, Wi-Fi and Ethernet addresses, FileVault status, battery cycle count and condition, last signed-in user, last startup. No files, no browsing history, no screenshots.
Can Edventory control the Mac?No. Like the Windows agent it is read-only: it sends facts and receives nothing.
How do I audit it?The collector is a plain shell script at /Library/Application Support/Edventory Agent/edventory-agent.sh, also viewable from the connector panel. Run it with --dry-run to print exactly what would be sent without sending it.
How do I remove it?In Terminal: sudo "/Library/Application Support/Edventory Agent/uninstall.sh". The background task, files, key and log are all removed.
The package says it can't be opened?Until the package is signed by Apple, macOS asks for confirmation: right-click it, choose Open, then Open again. The Terminal install doesn't need this step.
ℹ️
The agent runs quietly in the background: after startup it waits a few minutes, and the daily check-in happens at a random time in the morning, so a lab full of Macs doesn't report all at once.

More in 🔌 Data connectors

Still stuck? Contact support — or head back to the searchable Help Center.