Configuring a Jupyter Server

Using a Jupyter config file

By default, Jupyter Server looks for server-specific configuration in a jupyter_server_config file located on a Jupyter path. To list the paths where Jupyter Server will look, run:

$ jupyter --paths

config:
    /Users/username/.jupyter
    /usr/local/etc/jupyter
    /etc/jupyter
data:
    /Users/username/Library/Jupyter
    /usr/local/share/jupyter
    /usr/share/jupyter
runtime:
    /Users/username/Library/Jupyter/runtime

The paths under config are listed in order of precedence. If the same trait is listed in multiple places, it will be set to the value from the file with the highest precedence.

Jupyter Server uses IPython’s traitlets system for configuration. Traits can be listed in a Python or JSON config file. You can quickly create a jupyter_server_config.py file in the .jupyter directory, with all the defaults commented out, use the following command:

$ jupyter server --generate-config

In Python files, these traits will have the prefix c.ServerApp. For example, your configuration file could look like:

# inside a jupyter_server_config.py file.

c.ServerApp.port = 9999

The same configuration in JSON, looks like:

{
    "ServerApp": {
        "port": 9999
    }
}

Using the CLI

Alternatively, you can configure Jupyter Server when launching from the command line using CLI args. Prefix each argument with --ServerApp like so:

$ jupyter server --ServerApp.port=9999

Full configuration list

See the full list of configuration options for the server here.