[I 2026-11-09 14:52:14.962 SingleUserLabApp mixins:558] Starting jupyterhub single-user server version 5.5.5
[I 2026-11-09 14:52:14.962 SingleUserLabApp mixins:572] Extending jupyterlab.labhubapp.SingleUserLabApp from jupyterlab 4.6.4
[I 2026-11-09 14:52:14.963 SingleUserLabApp mixins:572] Extending jupyter_server.serverapp.ServerApp from jupyter_server 2.21.1
Single-user server for JupyterHub. Extends the Jupyter Notebook server.
Meant to be invoked by JupyterHub Spawners, not directly.
Options
=======
The options below are convenience aliases to configurable class-options,
as listed in the "Equivalent to" description-line of the aliases.
To see all configurable class-options for some <cmd>, use:
<cmd> --help-all
--debug
Set debug level for the extension and underlying server applications.
Equivalent to: [--ServerApp.log_level=DEBUG --ExtensionApp.log_level=DEBUG]
--show-config
Show the application's configuration (human-readable format)
Equivalent to: [--Application.show_config=True]
--show-config-json
Show the application's configuration (json format)
Equivalent to: [--Application.show_config_json=True]
--generate-config
generate default config file
Equivalent to: [--JupyterApp.generate_config=True]
-y
Answer yes to any questions instead of prompting.
Equivalent to: [--JupyterApp.answer_yes=True]
--allow-root
Allow the server to be run from root user.
Equivalent to: [--ServerApp.allow_root=True]
--no-browser
Prevent the opening of the default url in the browser.
Equivalent to: [--ServerApp.open_browser=False --ExtensionApp.open_browser=False]
--autoreload
Autoreload the webapp
Enable reloading of the tornado webapp and all imported Python packages
when any changes are made to any Python src files in server or
extensions.
Equivalent to: [--ServerApp.autoreload=True]
--script
DEPRECATED, IGNORED
Equivalent to: [--FileContentsManager.save_script=True]
--no-script
DEPRECATED, IGNORED
Equivalent to: [--FileContentsManager.save_script=False]
--core-mode
Start the app in core mode.
Equivalent to: [--LabApp.core_mode=True]
--dev-mode
Start the app in dev mode for running from source.
Equivalent to: [--LabApp.dev_mode=True]
--skip-dev-build
Skip the initial install and JS build of the app in dev mode.
Equivalent to: [--LabApp.skip_dev_build=True]
--watch
Start the app in watch mode.
Equivalent to: [--LabApp.watch=True]
--splice-source
Splice source packages into app directory.
Equivalent to: [--LabApp.splice_source=True]
--expose-app-in-browser
Expose the global app instance to browser via window.jupyterapp.
Equivalent to: [--LabApp.expose_app_in_browser=True]
--extensions-in-dev-mode
Load prebuilt extensions in dev-mode.
Equivalent to: [--LabApp.extensions_in_dev_mode=True]
--collaborative
To enable real-time collaboration, you must install the extension `jupyter_collaboration`.
You can install it using pip for example:
python -m pip install jupyter_collaboration
This flag is now deprecated and will be removed in JupyterLab v5.
Equivalent to: [--LabApp.collaborative=True]
--custom-css
Load custom CSS in template html files. Default is False
Equivalent to: [--LabApp.custom_css=True]
--disable-user-config
Disable user-controlled configuration of the notebook server.
Equivalent to: [--SingleUserNotebookApp.disable_user_config=True]
--log-level=<Enum>
Set the log level by value or name.
Choices: any of [0, 10, 20, 30, 40, 50, 'DEBUG', 'INFO', 'WARN', 'ERROR', 'CRITICAL']
Default: 30
Equivalent to: [--Application.log_level]
--config=<Unicode>
Full path of a config file.
Default: ''
Equivalent to: [--JupyterApp.config_file]
--ip=<Unicode>
The IP address the Jupyter server will listen on.
Default: 'localhost'
Equivalent to: [--ServerApp.ip]
--port=<Int>
The port the server will listen on (env: JUPYTER_PORT).
Default: 0
Equivalent to: [--ServerApp.port]
--port-retries=<Int>
The number of additional ports to try if the specified port is not available
(env: JUPYTER_PORT_RETRIES).
Default: 50
Equivalent to: [--ServerApp.port_retries]
--sock=<Unicode>
The UNIX socket the Jupyter server will listen on.
Default: ''
Equivalent to: [--ServerApp.sock]
--sock-mode=<Unicode>
The permissions mode for UNIX socket creation (default: 0600).
Default: '0600'
Equivalent to: [--ServerApp.sock_mode]
--transport=<CaselessStrEnum>
Choices: any of ['tcp', 'ipc'] (case-insensitive)
Default: 'tcp'
Equivalent to: [--KernelManager.transport]
--keyfile=<Unicode>
The full path to a private key file for usage with SSL/TLS.
Default: ''
Equivalent to: [--ServerApp.keyfile]
--certfile=<Unicode>
The full path to an SSL/TLS certificate file.
Default: ''
Equivalent to: [--ServerApp.certfile]
--client-ca=<Unicode>
The full path to a certificate authority certificate for SSL/TLS client
authentication.
Default: ''
Equivalent to: [--ServerApp.client_ca]
--notebook-dir=<Unicode>
The directory to use for notebooks and kernels.
Default: ''
Equivalent to: [--ServerApp.root_dir]
--preferred-dir=<Unicode>
Preferred starting directory to use for notebooks and kernels.
ServerApp.preferred_dir is deprecated in jupyter-server 2.0. Use
FileContentsManager.preferred_dir instead
Default: ''
Equivalent to: [--ServerApp.preferred_dir]
--browser=<Unicode>
Specify what command to use to invoke a web browser when starting the
server. If not specified, the default browser will be determined by the
`webbrowser` standard library module, which allows setting of the BROWSER
environment variable to override it.
Default: ''
Equivalent to: [--ServerApp.browser]
--pylab=<Unicode>
DISABLED: use %pylab or %matplotlib in the notebook to enable matplotlib.
Default: 'disabled'
Equivalent to: [--ServerApp.pylab]
--gateway-url=<Unicode>
The url of the Kernel or Enterprise Gateway server where kernel
specifications are defined and kernel management takes place. If defined,
this Notebook server acts as a proxy for all kernel management and kernel
specification retrieval. (JUPYTER_GATEWAY_URL env var)
Default: None
Equivalent to: [--GatewayClient.url]
--user=<CUnicode>
Default: ''
Equivalent to: [--SingleUserNotebookApp.user]
--group=<CUnicode>
Default: ''
Equivalent to: [--SingleUserNotebookApp.group]
--hub-prefix=<Unicode>
Default: '/hub/'
Equivalent to: [--SingleUserNotebookApp.hub_prefix]
--hub-host=<Unicode>
Default: ''
Equivalent to: [--SingleUserNotebookApp.hub_host]
--hub-api-url=<Unicode>
Default: ''
Equivalent to: [--SingleUserNotebookApp.hub_api_url]
--base-url=<Unicode>
The base URL for the Jupyter server.
Leading and trailing slashes can be omitted, and will automatically be
added.
Default: '/'
Equivalent to: [--SingleUserNotebookApp.base_url]
To see all available configurables, use `--help-all`.
Options (42)
| Option | Description | Source |
|---|---|---|
--debug | Set debug level for the extension and underlying server applications. | help |
--show-config | Show the application's configuration (human-readable format) Equivalent to: [--Application.show_config=True] | help |
--show-config-json | Show the application's configuration (json format) Equivalent to: [--Application.show_config_json=True] | help |
--generate-config | generate default config file Equivalent to: [--JupyterApp.generate_config=True] | help |
-y | Answer yes to any questions instead of prompting. | help |
--allow-root | Allow the server to be run from root user. | help |
--no-browser | Prevent the opening of the default url in the browser. | help |
--autoreload | Autoreload the webapp Enable reloading of the tornado webapp and all imported Python packages when any changes are made to any Python src files in server or extensions. | help |
--script | DEPRECATED, IGNORED Equivalent to: [--FileContentsManager.save_script=True] | help |
--no-script | DEPRECATED, IGNORED Equivalent to: [--FileContentsManager.save_script=False] | help |
--core-mode | Start the app in core mode. | help |
--dev-mode | Start the app in dev mode for running from source. | help |
--skip-dev-build | Skip the initial install and JS build of the app in dev mode. | help |
--watch | Start the app in watch mode. | help |
--splice-source | Splice source packages into app directory. | help |
--expose-app-in-browser | Expose the global app instance to browser via window.jupyterapp. | help |
--extensions-in-dev-mode | Load prebuilt extensions in dev-mode. | help |
--collaborative | To enable real-time collaboration, you must install the extension `jupyter_collaboration`. | help |
--custom-css | Load custom CSS in template html files. | help |
--disable-user-config | Disable user-controlled configuration of the notebook server. | help |
--log-level Enum | Set the log level by value or name. | help |
--config Unicode | Full path of a config file. | help |
--ip Unicode | The IP address the Jupyter server will listen on. | help |
--port Int | The port the server will listen on (env: JUPYTER_PORT). | help |
--port-retries Int | The number of additional ports to try if the specified port is not available (env: JUPYTER_PORT_RETRIES). | help |
--sock Unicode | The UNIX socket the Jupyter server will listen on. | help |
--sock-mode Unicode | The permissions mode for UNIX socket creation (default: 0600). | help |
--transport CaselessStrEnum | Choices: any of ['tcp', 'ipc'] (case-insensitive) Default: 'tcp' Equivalent to: [--KernelManager.transport] | help |
--keyfile Unicode | The full path to a private key file for usage with SSL/TLS. | help |
--certfile Unicode | The full path to an SSL/TLS certificate file. | help |
--client-ca Unicode | The full path to a certificate authority certificate for SSL/TLS client authentication. | help |
--notebook-dir Unicode | The directory to use for notebooks and kernels. | help |
--preferred-dir Unicode | Preferred starting directory to use for notebooks and kernels. | help |
--browser Unicode | Specify what command to use to invoke a web browser when starting the server. | help |
--pylab Unicode | DISABLED: use %pylab or %matplotlib in the notebook to enable matplotlib. | help |
--gateway-url Unicode | The url of the Kernel or Enterprise Gateway server where kernel specifications are defined and kernel management takes place. | help |
--user CUnicode | Default: '' Equivalent to: [--SingleUserNotebookApp.user] | help |
--group CUnicode | Default: '' Equivalent to: [--SingleUserNotebookApp.group] | help |
--hub-prefix Unicode | Default: '/hub/' Equivalent to: [--SingleUserNotebookApp.hub_prefix] | help |
--hub-host Unicode | Default: '' Equivalent to: [--SingleUserNotebookApp.hub_host] | help |
--hub-api-url Unicode | Default: '' Equivalent to: [--SingleUserNotebookApp.hub_api_url] | help |
--base-url Unicode | The base URL for the Jupyter server. | help |