# 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](https://hub.jaas.datalab.tuwien.ac.at). How you log in depends on how you use it:

=== "Course (TUWEL)"

    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.

=== "Research group or TU account"

    Open [hub.jaas.datalab.tuwien.ac.at](https://hub.jaas.datalab.tuwien.ac.at) and choose **Sign in with dataLAB** to log in with your TU Wien account.

=== "GitLab"

    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](https://datalab.tuwien.ac.at/science/jaas/group-work/). |
| **Environment** | The software and resources. Each card shows memory, CPU, GPU and the [flavors](https://datalab.tuwien.ac.at/science/jaas/software-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. |

!!! info "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](https://datalab.tuwien.ac.at/science/jaas/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](https://datalab.tuwien.ac.at/science/jaas/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:

1. Choose **File → Hub Control Panel**.
2. Click **Stop My Server**.
3. 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](https://datalab.tuwien.ac.at/science/jaas/files/): where to save your work
- [Software and flavors](https://datalab.tuwien.ac.at/science/jaas/software-flavors/): what is installed and how to add more
- [Working in a group](https://datalab.tuwien.ac.at/science/jaas/group-work/) if your course uses groups