Document enabling the configurator

This commit is contained in:
GeorgianaElena
2021-04-06 18:04:43 +03:00
parent 4fc26bc5ef
commit 5786dce367
2 changed files with 29 additions and 0 deletions

View File

@@ -17,3 +17,4 @@ Topic guides provide in-depth explanations of specific topics.
authenticator-configuration authenticator-configuration
escape-hatch escape-hatch
idle-culler idle-culler
jupyterhub-configurator

View File

@@ -0,0 +1,28 @@
.. _topic/jupyterhub-configurator:
=======================
JupyterHub Configurator
=======================
The `JupyterHub configurator <https://github.com/yuvipanda/jupyterhub-configurator>`_ allows admins to change a subset of hub settings via a GUI.
.. image:: ../images/jupyterhub-configurator.png
:alt: Changing the default JupyterHub interface
Enabling the configurator
=========================
Because the configurator is under continue development and it might change over time, it is disabled by default in TLJH.
If you want to experiment with it, it can be enabled using ``tljh-config``:
.. code-block:: bash
sudo tljh-config set services.configurator.enabled True
sudo tljh-config reload
Accessing the Configurator
==========================
After enabling the configurator using ``tljh-config``, the service will only be available to hub admins, from within the control panel.
The configurator can be accessed from under ``Services`` in the top navigation bar. It will ask to authenticate, so it knows the user is an admin.
Once done, the configurator interface will be available.