Skip to content

Install the agent

The mngd agent is a small macOS daemon that reports installed software, scans for CVEs, and applies patches on a schedule. Installing it is the first step after signing up.

From the Mac you want to enroll, run:

Terminal window
curl -fsSL https://api.mngd.app/enroll/<orgID-first-8>/agent.sh | sudo bash

The full command (with your orgID filled in) is shown in the web app on the Get started page and in Settings → Enrollment.

The script downloads the signed + notarized pkg, installs it at /usr/local/bin/mngd-agent, registers it as a launchd daemon, and writes your organization ID into the com.mngd preferences suite. The agent checks in within 30 seconds.

If your shell blocks pipe-to-shell, or a corporate security tool flags the curl command, you can install by hand.

  1. Download the pkg:

    mngd-agent-latest.pkg

  2. Double-click to install. Gatekeeper accepts it — it’s signed with our Developer ID and notarized by Apple.

  3. In Terminal, point the agent at your org:

    Terminal window
    defaults write com.mngd OrganizationID "<your-full-org-uuid>"
    defaults write com.mngd ManualServerURL "https://api.mngd.app"

    Your full organization UUID is shown on the Get started page.

  4. Open mngd from your Applications folder. It checks in within 30 seconds.

  • macOS 14 (Sonoma) or later
  • Apple silicon or Intel
  • Network access to api.mngd.app and cdn.mngd.app

Once the agent is running, head to enrollment for the MDM-side setup (only required for mngd — mngd patch is agent-only).