Troubleshooting
Fix-first guides for common Orion setup and notebook issues.
Connection and Jupyter
| Problem | Guide |
|---|---|
| macOS or Windows blocks the desktop installer | Desktop install security warnings |
First run fails with MODULE_NOT_FOUND / ensure-native-modules | Fix: first-run native modules error |
| 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 |
| Orion Cloud publish or Open in Orion import fails | Fix Orion Cloud publish and import issues |
Settings
| Problem | Guide |
|---|---|
| Bad edit to user settings JSON; need to undo | Restore user settings from backup |
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 June 2026.