the-littlest-jupyterhub/docs/admin.md

Administrative Access

In The Littlest JupyterHub, we try to allow users to do as many administrative tasks as possible within JupyterHub itself. Admin users can:

1. Have full root access with passwordless sudo
2. Install systemwide packages with apt
3. Install conda / pip packages for all JupyterHub
4. Change amount of RAM / CPU available to each user and more!

By default, there are no admin users. You should add some after installation.

Adding admin users

Admin users are specified in the YAML config file at /opt/tljh/config.yaml.

1. Open the config.yaml file for editing.

   sudo nano /opt/tljh/config.yaml
   

2. Add usernames that should have admin access.

   users:
     admin:
       - user1
       - user2
   

   Be careful around the syntax - indentation matters, and you should be using spaces and not tabs.

   When you are done, save the file and exit. In nano, you can do this with Ctrl+X key.

3. When you are sure the format is ok, restart JupyterHub to let the config take effect.

   sudo systemctl restart jupyterhub
   

This should give you admin access from JupyterHub! You can verify this by:

1. Opening a Terminal in your JupyterHub and checking if sudo works
2. Opening your JupyterHub Control Panel and checking for the Admin tab

From now on, you can use the JupyterHub to do most configuration changes.