The Furl Agent provides endpoint context, health and management capabilities for your organization. This guide covers everything you need to know to successfully deploy and configure the agent.

Table of Contents

1. System Requirements
   • macOS
   • Windows
2. Configuration
   • macOS Configuration
     • Method 1: Manual Configuration (macOS)
     • Method 2: MDM Configuration (Recommended for macOS)
   • Windows Configuration
     • Registry Configuration
   • Manual Permissions Setup
3. Deployment
   • Download Installation Packages
   • macOS Installation
   • Windows Installation
   • Silent Installation
     • macOS Silent Install
     • Windows Silent Install
   • Mass Deployment via MDM
     • macOS Deployment via MDM
     • Windows Deployment via MDM
4. FAQ
   • How do I know if the agent is running successfully?
   • What network connectivity does the agent require?
   • Can I install the agent on virtual machines?
   • How do I update the agent?
   • What data does the agent collect?
5. Troubleshooting
   • Agent Not Appearing in System Tray
   • Agent Shows “Not Running” Status
   • Installation Fails
   • Log File Locations
     • macOS Logs
     • Windows Logs
   • Getting Additional Help
   • Uninstalling the Agent
     • macOS Uninstall
     • Windows Uninstall

System Requirements

macOS

• Operating System: macOS 14.4 (Sonoma) or later
• Architecture: Intel (x64) and Apple Silicon (ARM64)
• Disk Space: Minimum 100 MB available storage
• Permissions: Administrator access required for installation

Windows

• Operating System: Windows 10 or Windows Server 2016 and later
• Architecture: x64, ARM64, or ARM
• Disk Space: Minimum 100 MB available storage
• Permissions: Administrator access required for installation

Configuration

Important: We strongly recommend deploying configuration before installing the agent to ensure proper setup and connectivity.

The Furl Agent requires two types of configuration:

1. Signed Configuration Data: Provided by Furl, contains agent settings and connectivity information
2. System Configuration: Operating system permissions and settings required for agent functionality

macOS Configuration

Method 1: Manual Configuration (macOS)

1. Download the configuration plist from your Furl agent settings page.
2. Copy the agent plist to /Library/Preferences/ai.furl.agent.plist
3. Manually configure system permissions (see Permissions section below)

Method 2: MDM Configuration (Recommended for macOS)

If you use an MDM solution like JAMF, Mosyle, or Apple Business Essentials:

1. Download the .mobileconfig file from your Furl agent settings menu
2. Deploy the .mobileconfig through your MDM system
3. The .mobileconfig will automatically:
   • Configure agent settings
   • Request necessary system permissions
   • Set up Full Disk Access and other security permissions

Windows Configuration

Registry Configuration

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

2. Import the registry file on target systems:

   regedit /s FurlAgent.reg

3. The registry configuration will set up agent connectivity and basic settings

Manual Permissions Setup

If you’re not using an MDM system on macOS, you’ll need to manually configure the following permissions after installation:

To enable notifications on macOS:

1. Open System Preferences/Settings
2. Click on “Notifications & Focus” (or “Notifications” on older versions)
3. Find “Furl Agent” in the list of applications
4. Enable notifications and configure desired alert style:
   • Allow notifications
   • Choose banner or alert style
   • Enable sounds if desired
   • Configure other notification preferences as needed

To enable Full Disk Access on macOS:

1. Open System Preferences/Settings
2. Click on “Privacy & Security” (or “Security & Privacy” on older versions)
3. Select “Full Disk Access” from the left sidebar
4. Click the lock icon and authenticate if needed
5. Click the ”+” button to add an application
6. Navigate to /Library/Furl/Furl Agent.app.
7. Select the app and click “Open”
8. Ensure the checkbox next to the Furl Agent is checked

Note: Full Disk Access is required for the agent to properly scan and monitor application changes on the system. Without this permission, some security and remediation features may be limited.

Deployment

Download Installation Packages

1. Log into your Furl dashboard
2. Navigate to Settings > Agent
3. Download the appropriate installer for your platform:
   • macOS: furl-agent-[version].pkg (signed package)
   • Windows: furl-agent-[version].msi (signed installer)

macOS Installation

1. Double-click the downloaded .pkg file
2. Follow the installation wizard prompts
3. Enter administrator credentials when prompted
4. The installer will:
   • Install the Furl Agent app to /Applications/Furl.app
   • Install system services to /Library/Furl/
   • Configure launch daemons for automatic startup

Windows Installation

1. Right-click the downloaded .msi file and select “Run as administrator”
2. Follow the installation wizard prompts
3. The installer will:
   • Install agent components to Program Files\Furl\Agent
   • Configure Windows services for automatic startup
   • Set up system data directories in ProgramData\Furl\Agent

Silent Installation

macOS Silent Install

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

Windows Silent Install

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

Mass Deployment via MDM

For organizations managing large fleets of devices, Mobile Device Management (MDM) solutions provide the most efficient way to deploy the Furl Agent across your entire infrastructure.

macOS Deployment via MDM

Supported MDM Solutions:

MDM solutions that support deploying an Apple pkg installer may be used (e.g., Apple Business Essentials, JAMF, etc.)

Deployment Steps:

1. Download the signed .pkg installer from your Furl dashboard
2. Upload the .pkg file to your MDM solution’s package management system
3. Create a deployment policy/configuration profile that includes:
   • The Furl Agent .pkg installer
   • The .mobileconfig file (downloaded from your Furl agent settings)
4. Target the appropriate device groups or organizational units
5. Schedule the deployment (immediate or maintenance window)

Best Practices:

• Deploy the .mobileconfig configuration before or simultaneously with the agent installation
• Use staged rollouts to monitor deployment success
• Configure automatic restart policies if required
• Test deployment on a small pilot group first

Windows Deployment via MDM

Supported MDM Solutions:

MDM solutions that support deploying an MSI installer may be used (e.g., Intune, etc.).

Deployment Steps:

1. Download the signed .msi installer from your Furl dashboard
2. Upload the .msi file to your MDM solution’s application catalog
3. Configure installation parameters:
   • Silent installation: /quiet /norestart
   • Registry configuration deployment (.reg file from Furl dashboard)
4. Create deployment groups or collections
5. Deploy to target devices with appropriate scheduling

Group Policy Deployment:

1. Copy the .msi file to a network share accessible by target computers
2. Create a new Group Policy Object (GPO)
3. Navigate to Computer Configuration > Policies > Software Settings > Software Installation
4. Right-click and select New > Package
5. Browse to the .msi file location and configure deployment options
6. Link the GPO to the appropriate Organizational Unit

Best Practices:

• Deploy registry configuration before agent installation
• Use maintenance windows for deployment to minimize user disruption
• Configure installation logging for troubleshooting: msiexec /i furl-agent-[version].msi /quiet /norestart /l*v C:\Temp\FurlInstall.log
• Monitor deployment status through your MDM console
• Plan for automatic retries on failed installations

FAQ

How do I know if the agent is running successfully?

The easiest way to check agent status is through the system tray:

• System Tray Icon: Look for the Furl icon in your system tray (macOS menu bar or Windows system tray)
• Status Indicator: Click the tray icon to view the status
  • Status: Running - Agent is operating normally
  • Status: Not Running - Agent services are not active

What network connectivity does the agent require?

The Furl Agent requires outbound HTTPS connectivity to Furl’s cloud infrastructure. Specific endpoints and ports will be provided in your configuration.

Can I install the agent on virtual machines?

Yes, the Furl Agent supports installation on virtual machines running supported operating systems.

How do I update the agent?

Agent updates are currently manual and require redeployment. You can update the agent by:

• MDM Systems: Deploy the latest package through your MDM solution (JAMF, Intune, etc.)
• Group Policy: Use Windows Group Policy to distribute the new MSI package
• Manual Installation: Download and install the latest package from your Furl dashboard over the existing installation

What data does the agent collect?

The agent collects endpoint telemetry data as configured in your organization’s policy. Specific data collection details are available in your Furl dashboard under compliance and data handling documentation.

Troubleshooting

Agent Not Appearing in System Tray

Symptoms: No Furl icon visible in system tray/menu bar

Solutions:

1. Check if agent services are running:
   • macOS: sudo launchctl list | grep furl
   • Windows: Check Services.msc for “Furl” services
2. Restart agent services:
   • macOS: sudo launchctl start ai.furl.agent.management
   • Windows: Restart “Furl Agent Management” service
3. Reinstall the agent if services are not present

Agent Shows “Not Running” Status

Symptoms: Tray icon present but shows “Status: Not Running”

Solutions:

1. Verify configuration is properly deployed
2. Check system permissions (especially Full Disk Access on macOS)
3. Review agent logs for specific error messages
4. Ensure network connectivity to Furl services

Installation Fails

macOS:

• Verify the installer package is signed and not corrupted
• Check that you have administrator privileges

Windows:

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

Log File Locations

macOS Logs

• System logs: Use Console.app and search for “furl”

Windows Logs

• Event logs: Windows Event Viewer > Applications and Services Logs

Getting Additional Help

If you continue to experience issues:

1. Collect relevant log files from the locations above
2. Note the exact error messages and symptoms
3. Include system information (OS version, architecture)
4. Contact Furl support with this information

Uninstalling the Agent

macOS Uninstall

The agent install consists of two main application components, two launch daemons, and an application data directory:

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

Alternatively, you can see the entire expanded tree that was written to disk during install with the following command:

pkgutil --files ai.furl.agent

Aside from the directories above, there is a data directory that is created when the agent starts for the first time:

• /Library/Application Support/Furl - Agent service data directories.

Windows Uninstall

Use Windows “Add or Remove Programs” to uninstall “Furl Agent”, or use:

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

Separately, you can remove C:\ProgramData\Furl to remove the data directory associated with the Furl Agent.

---

For additional support and documentation, visit your Furl dashboard or contact support@furl.ai