# Troubleshooting

| Symptom | Fix |
|---------|-----|
| `EADDRINUSE` 3041/3000 | `npm run stop:sovereign` or close the terminal running `npm start` |
| `uniqueidentifier` conversion on `/api/fleet/collection-targets` | Restart API after upgrade: `npm run restart:sovereign` |
| Migrate skips v1 | Expected on existing DB; run `npm run deploy:cold` to prove greenfield |
| Collector can't connect | Check `Encrypt`/`TrustServerCertificate` env; verify target grants |
| License limit | `GET /api/license` — increase entitlement or remove inactive servers |

## Diagnostics bundle

```powershell
.\scripts\collect-diagnostics.ps1
```

Sends a zip under `_readiness/diagnostics-<timestamp>/` for support.
