Home

Awesome

JupyterLab Desktop

JupyterLab Desktop is the cross-platform desktop application for JupyterLab. It is the quickest and easiest way to get started with Jupyter notebooks on your personal computer, with the flexibility for advanced use cases.

JupyterLab Desktop

Installation

Install JupyterLab Desktop using one of the methods listed below for your system.

Windows (10, 11)Mac (macOS 10.15+)Linux
x64 Installerarm64 Installer (Apple silicon)Snap Store [recommended]
x64 Installer (Intel chip).deb x64 Installer (Debian, Ubuntu)
.rpm x64 Installer (Red Hat, Fedora, SUSE)

Additionally, JupyterLab Desktop can be installed on Windows via winget: winget install jupyterlab.

If you need to remove a previous JupyterLab Desktop installation, please follow the uninstall instructions.

Launching JupyterLab Desktop

JupyterLab Desktop can be launched from the GUI of your operating system by clicking the application's icon or by using jlab command from the command line. Double clicking .ipynb files is also supported and it will launch JupyterLab Desktop and load the notebook file.

JupyterLab Desktop sets File Browser's root directory based on the launch method.

Sessions and Projects

Sessions represent local project launches and connections to existing JupyterLab servers. Each JupyterLab UI window in the app is associated with a separate session and sessions can be restored with the same configuration later on.

Each launch of JupyterLab in a different working directory is a separate project and projects can have their own configuration such as Python environment and UI layout.

Session start options

You can start a new session by using the links at the Start section of the Welcome Page.

<img src="media/start-session.png" alt="Start session" width=220 />

Similarly, CLI launches of the application, dropping files and folders, and double clicking to open files create new sessions as well.

Previously opened sessions are stored as part of application data and they are listed on Welcome Page. Clicking an item in the Recent sessions list restores the selected session.

<img src="media/recent-sessions.png" alt="Recent sessions" width=300 />

jlab command-line launch examples

See CLI documentation for more CLI commands and options.

JupyterLab Extension support

JupyterLab Desktop currently supports user-friendly prebuilt extensions. Source extensions which require rebuilding are not supported.

Guides and Help