Jupyter Notebook is deprecated and it is advised to transition to JupyterLab.

Please note that this repository is currently maintained by a skeleton crew of maintainers from the Jupyter community. We encourage users to transition to JupyterLab, where more immediate support can occur.

The recent issue #1205 has shown that keeping both may lead to issues.

The newly preferred backend for JupyterLab 3.0 is jupyter-server instead of notebook: https://jupyterlab.readthedocs.io/en/stable/getting_started/changelog.html#jupyter-server.

Roadmap

1. Deprecation: Maintain compatibility with both backends and deprecate Jupyter Notebook. Jupyter Notebook remains the default but a message indicates that it is advised to transition to JupyterLab.
2. Switch the default to JupyterLab: Switch to JupyterLab by default. It is still possible to start Jupyter Notebook by positioning a new JUPYTER_ENABLE_NB variable.
3. Drop Jupyter Notebook: Move to jupyter_server alone and point people to nbclassic for a classic-like experience. It provides the Notebook UI as a new-server extension and also translates old-server extensions into new-server extensions. (To be clear, this isn't just something that looks like the Notebook UI, it is literally the same code, running through the compatibility layer.)

Note: Another option could be retrolab - the look and feel of the Notebook UI but built with Lab components.

Deprecation

• Done -> PR Jupyter Notebook Deprecation Notice #1209

Changes

• With no option (no specific environment variable): Jupyter Notebook is launched (no change). However a warning / deprecation message is printed pointing to the dedicated section in the README.
• With JUPYTER_ENABLE_LAB: Jupyter Lab is launched (no change).
• Notice added in README

Switch the default to JupyterLab

• Done -> PR Jupyter Notebook deprecation -> default to JupyterLab #1575

Changes

• With no option (no specific environment variable): JupyterLab is launched.
• With JUPYTER_ENABLE_LAB: JupyterLab is launched. A warning message informs that this option is no more required.
• With DOCKER_STACKS_JUPYTER_CMD=notebook: Jupyter Notebook is launched. This variable also allows to run other jupyter commands
• Documentation is updated to document the new default and the new start option

Drop Jupyter Notebook support

• Not planned

Changes

• Jupyter Notebook support dropped (along with corresponding environment variables).
• A solution providing a classic-like UI built atop of JupyterLab will be proposed. The solution is not chosen at this time.