Agent Won't Start

Troubleshooting steps when the Fabric Agent fails to launch

macOS

"App is damaged and can't be opened"

This happens when Gatekeeper blocks the app.

Fix:

1. Open System Preferences then Security & Privacy
2. Look for a message about FabricAgent being blocked
3. Click "Open Anyway"

"App can't be opened because it is from an unidentified developer"

Fix:

1. Right-click the app
2. Select "Open"
3. Click "Open" in the dialog

Windows

"Windows protected your PC" (SmartScreen)

Fix:

1. Click "More info"
2. Click "Run anyway"

Service will not install

Fix: Run as Administrator

1. Right-click Command Prompt
2. Select "Run as administrator"
3. Navigate to Fabric folder
4. Run the service installation

UI shows "Daemon Error"

Check service status: Open Windows Services and look for FabricAgentDaemon

Restart service: Right-click the service and select Restart

Antivirus blocking the agent

Some antivirus software may flag the agent.

Fix:

• Add FabricAgent.exe to antivirus exclusions
• Add FabricAgentDaemon.exe to exclusions
• Add the Fabric folder in AppData to exclusions

Linux

Permission denied

Fix: Make the daemon executable using your file manager or terminal.

General Checks

Check internet connectivity

Ensure you can reach fabric.carmel.so in your browser.

Check firewall

Ensure outbound HTTPS (port 443) is allowed.

Check disk space

The agent needs space for:

• ML model cache (~500MB)
• Temporary workload files
• Logs

Check available space and clear if needed.

Still Not Working?

If none of the above helps:

Contact support@carmel.so with:

• Your operating system and version
• Error messages you see
• Steps you have tried