-
Notifications
You must be signed in to change notification settings - Fork 73
Troubleshooting
If you're having trouble with Positron, here are some and tools to help you get back on track.
Positron is an Electron app. If you're seeing what looks like a temporary glitch, you can try reloading the window. To do this, from the Command Palette, run the Developer: Reload Window command.
A window reload shouldn't cause you to lose any state, but it does cause the Positron front end and all language packs to restart.
Python and R logs are emitted in the Output panel. Each one starts several output channels that can be used to help diagnose problems with a respective part of the system.
Run the Output: Show Output Channels command to show a list of output channels. You can then select one to view its output by name, like "Positron R Extension". Here's a list of some Positron-specific channels you may be interested in:
| Channel | Description |
|---|---|
| Console: Python X.Y.Z | Communication with the Python kernel: requests to execute code, output shown in the Console, data used to build plots/environment/help panes, etc. |
| Console: R X.Y.Z | Communication with the R kernel (similar to Python) |
| Python Language Server | Debug logs from the server side of Positron's Python language server |
| Positron R Language Server | Debug logs from the server side of Positron's R language server |
Most of these output channels have a log level associated with them that you can change in the settings UI.
When looking for the source of an error, the developer tools can be helpful. From the Command Palette, run the Developer: Toggle Developer Tools command. Then, from the Developer Tools panel that appears, select the Console tab.
If you see an error in the developer tools related to the issue you're seeing, please include it when filing an issue on Github.
If you seem to have gotten things in a bad state, you can reset Positron to factory-fresh as follows. Close all Positron instances, then delete its state files:
rm -rf "~/Library/Application Support/Positron"
rm -rf ~/.positronThen, download the latest release of Positron and install it.
Finally, ask for help early and often. If you're having trouble as one of our beta testers, we'd like to hear about it, perhaps even before you blow away any state that might tell us what the issue was. Join us on GitHub Discussions!