Skip to content

Commit

Permalink
add disable auto-update troubleshoot section
Browse files Browse the repository at this point in the history
  • Loading branch information
mbektas committed Jan 19, 2024
1 parent 35c5bb2 commit 074c08b
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions troubleshoot.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ Below are detailed information on topics which commonly come up in questions and
- [Double clicking .ipynb files not launching JLD](#double-clicking-ipynb-files-not-launching-jld)
- [Detecting if an issue is specific to JupyterLab Desktop or not](#Detecting-if-an-issue-is-specific-to-JupyterLab-Desktop-or-not)
- [Debugging application launch issues](#Debugging-application-launch-issues)
- [Reverting to an older version and disabling auto-update](#Reverting-to-an-older-version-and-disabling-auto-update)

## JupyterLab Desktop vs JupyterLab Web Application versions

Expand Down Expand Up @@ -195,3 +196,19 @@ Application launch might fail for various reasons and it is best to check logs f
3. Try removing custom environment settings from `settings.json` and/or `desktop-settings.json`. You can see [configuration and data files section in User Guide](user-guide.md#Configuration-and-data-files) for the locations of these files in different systems. Retry launch and check logs.
4. Try removing application cache data from `app-data.json`. Retry launch and check logs.
5. Try to launch using `jlab --log-level debug` CLI command to check if there are any logs output in system Terminal.

## Reverting to an older version and disabling auto-update

JupyterLab Desktop automatically downloads and installs new versions on some platforms. If newer versions are causing compatibility issues or other problems you can reinstall an older version. Follow the steps below to disable auto-updates, and revert to an older version.

1. Close all running JupyterLab Desktop instances, make sure all processes have stopped.
2. Open your [User settings file](user-guide.md#configuration-and-data-files) and add the settings below.

```json
{
"checkForUpdatesAutomatically": false,
"installUpdatesAutomatically": false
}
```

3. Install older version of JupyterLab Desktop from the [Releases](https://github.com/jupyterlab/jupyterlab-desktop/releases/) page.

0 comments on commit 074c08b

Please sign in to comment.