ALERT! Warning: your browser isn't supported. Please install a modern one, like Firefox, Opera, Safari, Chrome or the latest Internet Explorer. Thank you!
Startseite » ... » Zentrale Einrichtungen  » ZIH  » Wiki
phone prefix: +49 351 463.....

HPC Support

Operation Status

Ulf Markwardt: 33640
Claudia Schmidt: 39833

Login and project application

Phone: 40000
Fax: 42328

You are here: Compendium » JupyterHub » Teaching

JupyterHub for Teaching

On this page we want to introduce to you some useful features if you want to use JupyterHub for teaching.

PLEASE UNDERSTAND: JupyterHub uses compute resources from the HPC system Taurus. Please be aware of the following notes:
  • The HPC system operates at a lower availability level than your usual Enterprise Cloud VM. There can always be downtimes, e.g. of the file systems or the batch system.
  • Scheduled downtimes are announced by email. Please plan your courses accordingly.
  • Access to HPC resources is handled through projects. See your course as a project. Projects need to be registered beforehand (more info on the page Access).
  • Don't forget to add your users (eg. students or tutors) to your project.
  • It might be a good idea to request a reservation of part of the compute resources for your project/course to avoid unnecessary waiting times in the batch system queue.

Clone a repository with a link

This feature bases on nbgitpuller ( documentation)

This extension for jupyter notebooks can clone every public git repository into the users work directory. It's offering a quick way to distribute notebooks and other material to your students.

Git pull progress screen

A sharable link for this feature looks like this:

URL with git-pull parameters

This example would clone the repository and afterwards open the Intro.ipynb notebook in the given path.

The following parameters are available:
parameter info
repo path to git repository
branch branch in the repository to pull from
default: master
urlpath URL to redirect the user to a certain file
more info
depth clone only a certain amount of latest commits
not recommended
This link generator might help creating those links.

Spawner options passthrough with URL params

The spawn form now offers a quick start mode by passing url parameters.
An example: The following link would create a jupyter notebook session on the interactive partition with the test environment being loaded:'interactive~environment~'test)

URL with quickstart parameters

Every parameter of the advanced form can be set with this parameter. If the parameter is not mentioned, the default value will be loaded.

parameter default value
partition default
nodes 1
ntasks 1
cpuspertask 1
gres empty (no generic resources)
mempercpu 1000
runtime 8:00:00
reservation empty (use no reservation)
project empty (use default project)
modules empty (do not load additional modules)
environment production
launch JupyterLab
workspace_scope empty (home directory)
You can use the advanced form to generate a url for the settings you want. The address bar contains the encoded parameters starting with #/.

Combination of quickstart and git-pull feature

You can combine both features in a single link:'interactive~environment~'test)

URL with git-pull and quickstart parameters

Open a notebook automatically with a single link

With the following link you will be redirected to a certain file in your home directory. The file needs to exist, otherwise a 404 error will be thrown.

URL with git-pull and quickstart parameters

This link would redirect to{login}/notebooks/demo.ipynb.