> ## Documentation Index
> Fetch the complete documentation index at: https://sdk.observability.getonex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

This page covers validation steps and resolutions for the governance client. Start with [Installation](installation) if the client is not yet deployed.

## Validation checklist

1. Confirm **Install OneX Governance** reported **Installed successfully**.
2. Fully restart the IDE or Visual Studio Code (a reload is not sufficient).
3. Use your assistant in a representative workflow: Agent mode, Copilot chat, or Claude Code.
4. Review the governance dashboard for new events.

If the dashboard remains empty, verify the installer API URL is `http://10.243.138.252/api` and that your personal token (or forwarder secret) and tenant match your [OneX dashboard](https://dashboard.observability.getonex.ai) account.

## Common issues

| Issue                         | Resolution                                                                                                                                                                                 |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 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](https://dashboard.observability.getonex.ai) 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)                                                                     |

## Credential rotation

Handle your personal token or forwarder secret as you would any service credential. If it may have been exposed, rotate it in your [OneX dashboard](https://dashboard.observability.getonex.ai) account and re-run **Install OneX Governance** with the updated value.

## Reinstalling

To fix a broken install or update credentials, run **Install OneX Governance** again from your organization's installer package. Enter the new values in the GUI and click **Install**. Fully restart your IDEs afterward.