Agent

The Furl agent runs on your endpoints to provide environment context, health status, and management capabilities. This guide covers installation, configuration, and troubleshooting on macOS and Windows.

System requirements

macOS

• 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

Windows

• Operating system: Windows 10 / Windows Server 2016 or later
• Architecture: x64, ARM64, or ARM
• Disk space: 100 MB minimum
• Permissions: Administrator access required for installation

Configuration

Deploy configuration before installing the agent. This ensures connectivity and permissions are in place when the agent starts.

The Furl agent needs two pieces of configuration:

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 on macOS, etc.).

macOS

Choose one of the following methods.

Manual configuration

1. Download the configuration plist from your Furl agent settings page.
2. Copy it to /Library/Preferences/ai.furl.agent.plist.
3. Configure the system permissions described in Manual permissions setup below.

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

Windows

Registry configuration

1. Download the registry key file (.reg) from your Furl agent settings page.

2. Import it on the target system:

   regedit /s FurlAgent.reg

The registry settings establish agent connectivity and basic configuration.

Manual permissions setup (macOS)

If you’re not using MDM on macOS, configure the following permissions manually after installation.

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.

Installation

Download the installer

1. Sign in to your Furl dashboard.
2. Go to Settings → Agent.
3. Download the installer for your platform:
   • macOS: furl-agent-[version].pkg (signed package)
   • Windows: furl-agent-[version].msi (signed installer)

macOS

1. Double-click the .pkg file.
2. Follow the wizard and authenticate as administrator.
3. The installer:
   • Installs the Furl Agent app to /Applications/Furl.app
   • Installs system services to /Library/Furl/
   • Configures launch daemons for automatic startup

Windows

1. Right-click the .msi and choose Run as administrator.
2. Follow the wizard.
3. The installer:
   • Installs the agent to Program Files\Furl\Agent
   • Configures Windows services for automatic startup
   • Creates data directories under ProgramData\Furl\Agent

Silent install

macOS:

sudo installer -pkg furl-agent-[version].pkg -target /

Windows:

msiexec /i furl-agent-[version].msi /quiet /norestart

Mass deployment via MDM

For fleets, MDM is the easiest way to deploy at scale.

macOS 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.

Windows via MDM

Any MDM that deploys an MSI installer will work (Intune, etc.).

1. Download the signed .msi from your Furl dashboard.
2. Upload it to your MDM’s application catalog.
3. Configure installation parameters:
   • Silent install: /quiet /norestart
   • Deploy the .reg configuration file from your Furl dashboard alongside the installer.
4. Create deployment groups and schedule the rollout.

Windows via Group Policy

1. Copy the .msi to a network share accessible by target computers.
2. Create a new GPO.
3. Navigate to Computer Configuration → Policies → Software Settings → Software Installation.
4. Right-click and choose New → Package.
5. Browse to the .msi and configure deployment options.
6. Link the GPO to the target Organizational Unit.

Best practices:

• Deploy the registry configuration before the agent installer.

• Use maintenance windows to minimize user disruption.

• Enable installation logging for troubleshooting:

  msiexec /i furl-agent-[version].msi /quiet /norestart /l*v C:\Temp\FurlInstall.log

FAQ

How do I know the agent is running?

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

What network connectivity does the agent need?

Outbound HTTPS to Furl’s cloud infrastructure. Specific endpoints and ports are documented in your dashboard’s agent configuration.

Can I install the agent on virtual machines?

Yes — VMs running supported operating systems are fully supported.

How do I update the agent?

Updates are currently manual. Re-deploy the latest installer the same way you originally deployed the agent (MDM, Group Policy, or manual install over the existing installation).

What data does the agent collect?

Endpoint telemetry as configured by your organization’s policy. Full data-handling details are available in your Furl dashboard under compliance documentation.

Troubleshooting

Agent not appearing in the system tray

Symptoms: No Furl icon in the menu bar or system tray.

Solutions:

1. Check whether the agent services are running:
   • macOS: sudo launchctl list | grep furl
   • Windows: Check Services.msc for “Furl” services
2. Restart the agent services:
   • macOS: sudo launchctl start ai.furl.agent.management
   • Windows: Restart the Furl Agent Management service
3. If the services are missing entirely, reinstall the agent.

Agent shows “Not running” status

Symptoms: Tray icon is present but reports Status: Not running.

Solutions:

1. Confirm the configuration was deployed correctly.
2. Check system permissions, especially Full Disk Access on macOS.
3. Review the agent logs (see below) for specific errors.
4. Verify network connectivity to Furl’s services.

Installation fails

macOS:

• Verify the installer is signed and not corrupted.
• Confirm you have administrator privileges.

Windows:

• Run the installer as Administrator.
• Check the Windows Event Viewer for installation errors.
• Verify the system meets the minimum requirements above.

Log file locations

• macOS: Use Console.app and search for furl.
• Windows: Windows Event Viewer → Applications and Services Logs.

Getting more help

If issues persist:

1. Collect the relevant log files.
2. Note the exact error messages and symptoms.
3. Include system information (OS version and architecture).
4. Contact Furl support at support@furl.ai.

Uninstall

macOS

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:

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.

Windows

Use Add or Remove Programs to uninstall Furl Agent, or run:

msiexec /x furl-agent-[version].msi /quiet

To clean up data, also remove C:\ProgramData\Furl.

---

For additional support, contact support@furl.ai.