Skip to content

Commit e6b6c13

Browse files
authored
Merge pull request #747 from mbektas/disable-auto-update
add disable auto-update troubleshoot section
2 parents 35c5bb2 + 074c08b commit e6b6c13

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

troubleshoot.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ Below are detailed information on topics which commonly come up in questions and
1919
- [Double clicking .ipynb files not launching JLD](#double-clicking-ipynb-files-not-launching-jld)
2020
- [Detecting if an issue is specific to JupyterLab Desktop or not](#Detecting-if-an-issue-is-specific-to-JupyterLab-Desktop-or-not)
2121
- [Debugging application launch issues](#Debugging-application-launch-issues)
22+
- [Reverting to an older version and disabling auto-update](#Reverting-to-an-older-version-and-disabling-auto-update)
2223

2324
## JupyterLab Desktop vs JupyterLab Web Application versions
2425

@@ -195,3 +196,19 @@ Application launch might fail for various reasons and it is best to check logs f
195196
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.
196197
4. Try removing application cache data from `app-data.json`. Retry launch and check logs.
197198
5. Try to launch using `jlab --log-level debug` CLI command to check if there are any logs output in system Terminal.
199+
200+
## Reverting to an older version and disabling auto-update
201+
202+
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.
203+
204+
1. Close all running JupyterLab Desktop instances, make sure all processes have stopped.
205+
2. Open your [User settings file](user-guide.md#configuration-and-data-files) and add the settings below.
206+
207+
```json
208+
{
209+
"checkForUpdatesAutomatically": false,
210+
"installUpdatesAutomatically": false
211+
}
212+
```
213+
214+
3. Install older version of JupyterLab Desktop from the [Releases](https://github.com/jupyterlab/jupyterlab-desktop/releases/) page.

0 commit comments

Comments
 (0)