Skip to content
Furl Docs

macOS

This guide covers installing and configuring the Furl agent on macOS endpoints. For shared FAQs and general troubleshooting, see the Agent overview.

System requirements

Section titled “System requirements”
  • Operating system: macOS 14.4 (Sonoma) or later
  • Architecture: Intel (x64) or Apple Silicon (ARM64)
  • Disk space: 100 MB minimum
  • Permissions: Administrator access required for installation

Before you install

Section titled “Before you install”

The Furl agent needs two pieces of configuration in place before it starts:

  1. Signed configuration data — agent settings and connectivity info, provided by Furl from your dashboard.
  2. System permissions — operating-system-level permissions (Full Disk Access, Notifications).

Download the installer from your Furl agent settings page (Settings → Agent):

  • macOS: furl-agent-[version].pkg (signed package)

How you deliver the configuration and permissions depends on your install method — see Automated deployment (recommended for fleets) or Manual installation below.

Automated deployment

Section titled “Automated deployment”

For fleets, MDM is the easiest way to deploy at scale — it delivers the agent, its configuration, and the required permissions in one step.

Silent install

Section titled “Silent install”
Terminal window
sudo installer -pkg furl-agent-[version].pkg -target /
Section titled “MDM configuration (recommended)”

If your organization uses an MDM solution (JAMF, Mosyle, Apple Business Essentials, etc.):

  1. Download the .mobileconfig file from your Furl agent settings page.
  2. Deploy it through your MDM. The profile automatically:
    • Configures agent settings
    • Requests the required system permissions
    • Sets up Full Disk Access and related security permissions

With MDM configuration, no manual permissions setup is required.

Deploy via MDM

Section titled “Deploy via MDM”

Any MDM that deploys an Apple .pkg installer will work (Apple Business Essentials, JAMF, Mosyle, etc.).

  1. Download the signed .pkg from your Furl dashboard.
  2. Upload it to your MDM’s package management.
  3. Create a deployment policy that includes both the .pkg and the .mobileconfig profile (also available in your Furl agent settings).
  4. Target the appropriate device groups.
  5. Schedule the deployment.

Best practices:

  • Deploy the .mobileconfig configuration before or alongside the agent.
  • Pilot on a small group before a wide rollout.
  • Configure automatic restart policies if your environment requires them.

Manual installation

Section titled “Manual installation”

If you’re not using MDM, configure the agent, set up permissions, then install the package.

Manual configuration

Section titled “Manual configuration”
  1. Download the configuration plist from your Furl agent settings page.
  2. Copy it to /Library/Preferences/ai.furl.agent.plist.
  3. Set up the system permissions described in Manual permissions setup below (after installation).

Install the package

Section titled “Install the package”
  1. Double-click the .pkg file.
  2. Follow the wizard and authenticate as administrator.

Manual permissions setup

Section titled “Manual permissions setup”

After installation, configure the following permissions manually.

Notifications

  1. Open System Settings → Notifications.
  2. Find Furl Agent in the application list.
  3. Allow notifications and choose your preferred alert style.

Full Disk Access

  1. Open System Settings → Privacy & Security → Full Disk Access.
  2. Click the lock icon and authenticate.
  3. Click + and add /Library/Furl/Furl Agent.app.
  4. Make sure the checkbox next to Furl Agent is enabled.

Full Disk Access is required for the agent to scan and monitor application changes. Without it, some security and remediation features will be limited.

FAQ & troubleshooting

Section titled “FAQ & troubleshooting”
How do I know the agent is running?

Look for the Furl icon in your menu bar. Click it to view status — it shows Running when the agent is healthy and Not running when its services aren’t active.

The agent isn’t appearing in the menu bar

Symptoms: No Furl icon in the menu bar.

Solutions:

  1. Check whether the agent services are running:

    Terminal window
    sudo launchctl list | grep furl

  2. Restart the agent services:

    Terminal window
    sudo launchctl start ai.furl.agent.management

  3. If the services are missing entirely, reinstall the agent.

Installation fails
  • Verify the installer is signed and not corrupted.
  • Confirm you have administrator privileges.
Where are the log files?

Use Console.app and search for furl.

How do I uninstall the agent?

The agent installs the following components:

  • /Applications/Furl.app — tray application
  • /Library/Furl/Furl Agent.app — system services (telemetryd, managementd)
  • /Library/LaunchDaemons/ai.furl.agent.management.service.plist — managementd daemon
  • /Library/LaunchDaemons/ai.furl.agent.telemetry.service.plist — telemetryd daemon

To list every file the package wrote:

Terminal window
pkgutil --files ai.furl.agent

The agent also creates a data directory the first time it runs:

  • /Library/Application Support/Furl — service data directory

Remove all of the above to fully uninstall.