| API connection failure | Verify API URL is http://10.243.138.252/api, confirm personal token or forwarder secret, and check outbound network access to the app server; re-run the installer with corrected values |
| No dashboard activity | Fully quit and reopen your IDE, then re-run Install OneX Governance |
| HTTP 401 on upload | Rotate your personal token in the dashboard and re-run the installer |
| Failure after IDE upgrade | Re-run Install OneX Governance |
| macOS blocks the installer | Open System Settings → Privacy & Security and click Open Anyway |
| Ran installer as Admin / sudo | Hooks went to the wrong profile. Re-run as your normal user |
| Windows username with spaces | Re-run the installer as your normal user (not Administrator) |
| VS Code Copilot not captured | Fully quit VS Code, reopen it, and allow the OneX extension to finish applying settings (a one-time restart is normal) |