From f69ef9f846b2b65d708d43101b51f4340e8b0b0b Mon Sep 17 00:00:00 2001 From: Zsailer Date: Mon, 11 Jan 2021 16:48:52 -0800 Subject: [PATCH] add docs describing jupyter_server --- docs/source/reference/config-user-env.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/source/reference/config-user-env.md b/docs/source/reference/config-user-env.md index c085b106..4a378831 100644 --- a/docs/source/reference/config-user-env.md +++ b/docs/source/reference/config-user-env.md @@ -179,3 +179,13 @@ The number of named servers per user can be limited by setting ```python c.JupyterHub.named_server_limit_per_user = 5 ``` + +## Switching to Jupyter Server + +[Jupyter Server](https://jupyter-server.readthedocs.io/en/latest/) is a new Tornado Server backend for Jupyter web applications (e.g. JupyterLab 3.0 uses this package as its default backend). + +By default, the single-user notebook server uses the (old) `NotebookApp` from the [notebook](https://github.com/jupyter/notebook) package. You can switch to using Jupyter Server's `ServerApp` backend (this will likely become the default in future releases) by setting the `JUPYTERHUB_SINGLEUSER_APP` environment variable to: + +```bash +export JUPYTERHUB_SINGLEUSER_APP='jupyter_server.serverapp.ServerApp' +```