Troubleshooting
Fix-first guides for common Orion setup and notebook issues.
Connection and Jupyter
| Problem | Guide |
|---|---|
| Connect Orion to your own Jupyter server | Connect to an external Jupyter server |
| Browser blocks connection / CORS errors | Fix Jupyter CORS connection errors |
Workspace skills not loading from .agents or .orion | Jupyter hidden folders and skills |
| Wrong Python or Jupyter not found | Kernel and Python selection |
Notebooks and UI
| Problem | Guide |
|---|---|
ModuleNotFoundError: No module named 'orion_ui' | Fix: orion_ui import error |
| Plotly charts look different in Orion | Plotly version compatibility |
| App View shows schema errors | Fix App View schema errors |
| PDF export fails immediately | Fix: PDF export blocked |
Providers and auth
| Problem | Guide |
|---|---|
| ChatGPT OAuth Continue button disabled | Enable device code authorization for Codex |
| Other ChatGPT connection issues | Fix ChatGPT OAuth issues |
Still stuck?
- Report a bug from chat with
/report-bug - Open an issue on GitHub
Last updated May 2026.