Add docs for escape hatch

This commit is contained in:
yuvipanda
2018-08-01 02:52:40 -07:00
parent edfbbd8ae9
commit c5fc1a70d7
2 changed files with 17 additions and 0 deletions

View File

@@ -83,6 +83,7 @@ Topic guides provide in-depth explanations of specific topics.
topic/installer-actions
topic/tljh-config
topic/authenticator-configuration
topic/escape-hatch
Troubleshooting

View File

@@ -0,0 +1,16 @@
.. _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
your configuration.
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
options specified by TLJH are loaded.