2018-08-01 02:52:40 -07:00
|
|
|
.. _topic/escape-hatch:
|
|
|
|
|
|
|
|
|
|
========================================
|
|
|
|
|
Custom ``jupyterhub_config.py`` snippets
|
|
|
|
|
========================================
|
|
|
|
|
|
|
|
|
|
Sometimes you need to customize TLJH in ways that are not officially supported.
|
|
|
|
|
We provide an easy escape hatch for those cases with a ``jupyterhub_conf.d``
|
|
|
|
|
directory that lets you load multiple ``jupyterhub_config.py`` snippets for
|
2018-08-02 10:57:26 -07:00
|
|
|
your configuration. You need to create the directory when you use it for
|
|
|
|
|
the first time.
|
2018-08-01 02:52:40 -07:00
|
|
|
|
|
|
|
|
Any files in ``/opt/tljh/jupyterhub_config.d`` that end in ``.py`` will be
|
|
|
|
|
loaded in alphabetical order as python files to provide configuration for
|
|
|
|
|
JupyterHub. Any config that can go in a regular ``jupyterhub_config.py``
|
|
|
|
|
file is valid in these files. They will be loaded *after* any of the config
|
2018-08-02 10:57:26 -07:00
|
|
|
options specified with ``tljh-config`` are loaded.
|