How to use this documentation
This documentation is written for two groups of readers. Most pages contain sections relevant to both, and we mark them clearly so you can jump to what matters to you.
Audiences
👩🎓 Participant (Student) You are taking a course that uses UZH JupyterHub. You want to know how to work effectively in the environment: running notebooks, managing files, understanding why your server stopped, etc.
👩🏫 Coach / Course Owner You are responsible for a JupyterHub deployment for your course. You manage user access, configure groups, set resource quotas, and help learners when things go wrong.
Where a section is only relevant to one group, it is introduced with the matching icon. Sections without an icon are relevant to everyone.
Getting started: your first login
👩🎓 Participants:
- Open your course in OLAT.
- Click the Start LTI learning module link your teacher has placed in the course. This logs you in to JupyterHub via your UZH edu-ID — you do not need a separate account or password.
- On the server-selection page, choose a server profile (your course may offer CPU and/or GPU options) and click Start. Starting can take a few minutes the first time.
- When your server is ready, JupyterLab opens. See JupyterHub Basics to find your way around.
If JupyterHub is currently stopped, you may first see the Start page instead — press Start and wait, then reload (see Start & Scale UI).
Topics covered
| Page | What you will find |
|---|---|
| JupyterHub Basics | The JupyterLab interface, Git, Python environments, and the UZH shared volume |
| Roles, Groups & Collaboration | How OLAT roles translate to JupyterHub access; group servers for team work |
| User management | Where users come from and how authentication and authorisation work |
| CPU & GPU Quota | Understanding and monitoring resource limits |
| FAQ | Frequently asked questions and quick-reference tips |
| Start & Scale UI | Cluster start/stop dashboard for teachers and students |