Getting started¶
This page takes you from logging in to your first notebook. It takes about five minutes.
1. Log in¶
JaaS lives at hub.jaas.datalab.tuwien.ac.at. How you log in depends on how you use it:
Open your TUWEL course and click the JupyterHub activity your lecturer created. You are logged in automatically.
Always enter through the course activity the first time: that is how JaaS learns which courses you are enrolled in.
Open hub.jaas.datalab.tuwien.ac.at and choose Sign in with dataLAB to log in with your TU Wien account.
Choose Sign in with GitLab to log in with your TU Wien GitLab account. Your server can then clone and push to your GitLab repositories without extra setup.
2. Choose what to start¶
After logging in you see the start form. Fill it in from top to bottom:
| Field | What to choose |
|---|---|
| Workspace | The course or project to work on. Shown if you belong to more than one. |
| Group | Personal for your own server. If your workspace has groups, choose your group to join its group server. |
| Environment | The software and resources. Each card shows memory, CPU, GPU and the flavors it includes. If there is only one, it is chosen for you. |
| GPU Type | Only for environments with a GPU: which GPU model to use. |
| Start as | Only for lecturers: instructor, or student to see what students see. |
Lab network only
An environment marked Lab network only is an exam environment. Its server can only be opened from the networks the course allows, for example the exam room or the TU VPN.
3. Start your server¶
Press Start. It takes a few seconds up to a couple of minutes, longer the first time an environment runs on a machine. Then JupyterLab opens.
4. Find your way around JupyterLab¶
- The file browser on the left shows your home folder. See Your files for what the folders are.
- The Launcher (the
+tab) opens notebooks, a terminal, VS Code, RStudio or the desktop. - Courses with assignments have an Assignments card in the Launcher; see Assignments.
5. Stop your server when you are done¶
Your server stops by itself after a while without activity, and your files in the home folder are kept. To stop it yourself, for example to start a different environment:
- Choose File → Hub Control Panel.
- Click Stop My Server.
- Start again with the start form, or Logout in the top right corner.
You can run up to three servers at once, for example one per course; the Hub Control Panel lists them.
Next steps¶
- Your files: where to save your work
- Software and flavors: what is installed and how to add more
- Working in a group if your course uses groups