# 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

---