# Jupyter as a Service

Jupyter as a Service (JaaS) gives students, researchers and lecturers at TU Wien a ready-to-use JupyterLab in the browser. There is nothing to install: you log in, choose what you want to work on, and your personal server starts with the software your course or project needs.

!!! tip "What's new"
    **Choose your software.** Environments are no longer one big image. Your lecturer or project lead picks the software packages you need, which we call [flavors](https://datalab.tuwien.ac.at/science/jaas/software-flavors/): Scientific Python and R, Julia, C/C++, MATLAB, CUDA and more. A course that only needs Python stays small and starts fast.

    **Real group work.** Groups used to work on their own servers with a shared folder, which could overwrite each other's changes. Now a group starts one [group server](https://datalab.tuwien.ac.at/science/jaas/group-work/): every member works on the same files at the same time, with real-time collaboration.

    **Choose your workspace at start.** If you are in several courses or projects, you pick the workspace, and for group work the group, before your server starts.

## How JaaS works

=== "Working on JaaS"

    <div class="grid cards" markdown>

    -   :material-login: **1. Log in**

        ---

        Through your TUWEL course, your TU account or GitLab.

    -   :material-form-select: **2. Choose**

        ---

        Your workspace, your group or a personal server, and an environment.

    -   :material-rocket-launch: **3. Start**

        ---

        Your server starts and JupyterLab opens in the browser.

    -   :material-notebook-edit: **4. Work**

        ---

        With your files, your software, your group and your assignments.

    </div>

    [Get started](https://datalab.tuwien.ac.at/science/jaas/getting-started/){ .md-button .md-button--primary }

=== "Setting up a course or project"

    <div class="grid cards" markdown>

    -   :material-folder-plus: **1. Create a workspace**

        ---

        In the [self-service portal](https://jaas.datalab.tuwien.ac.at), for a course or a research project.

    -   :material-link-variant: **2. Connect TUWEL**

        ---

        Enrolled students join automatically. For a research project, add members by e-mail.

    -   :material-tune-variant: **3. Choose environments**

        ---

        Flavors, size and GPU for the servers, and groups if you need them.

    -   :material-account-group: **4. Students log in**

        ---

        They start working, as shown in the other tab.

    </div>

    [Set up a course or project](https://datalab.tuwien.ac.at/science/jaas/instructors/){ .md-button .md-button--primary }

- A **workspace** is one course or research project. Your lecturer or project lead sets it up; you see every workspace you belong to.
- An **environment** is what your server runs: a set of [software flavors](https://datalab.tuwien.ac.at/science/jaas/software-flavors/) plus memory, CPU and possibly a GPU. A workspace can offer several.
- A **server** is your own JupyterLab. It keeps your files when it stops and starts again with your latest settings.
- A **group server** is one server shared by all members of a group.

## Find your way

This documentation follows the order in which you need it. Start at the top and go deeper where you need to.

### Working on JaaS

| I want to… | Read |
|---|---|
| log in and start my first server | [Getting started](https://datalab.tuwien.ac.at/science/jaas/getting-started/) |
| know where my files are and what I can change | [Your files](https://datalab.tuwien.ac.at/science/jaas/files/) |
| know which software I have, or add more | [Software and flavors](https://datalab.tuwien.ac.at/science/jaas/software-flavors/) |
| work on the same files with my group | [Working in a group](https://datalab.tuwien.ac.at/science/jaas/group-work/) |
| fetch and submit an assignment | [Assignments](https://datalab.tuwien.ac.at/science/jaas/assignments/) |
| fix a problem | [Troubleshooting](https://datalab.tuwien.ac.at/science/jaas/troubleshooting/) |

### Setting up a course or project

| I want to… | Read |
|---|---|
| understand what I can set up, and set up a course or project | [Overview and setup](https://datalab.tuwien.ac.at/science/jaas/instructors/) |
| choose software, size, GPU, or set up an exam | [Environments](https://datalab.tuwien.ac.at/science/jaas/instructors/environments/) |
| manage students, tutors and groups | [Members and groups](https://datalab.tuwien.ac.at/science/jaas/instructors/members-and-groups/) |
| share materials and datasets, grade assignments | [Materials and grading](https://datalab.tuwien.ac.at/science/jaas/instructors/materials-and-grading/) |

## What JaaS offers

- **JupyterLab in the browser** with notebooks, a terminal, VS Code, RStudio and a Linux desktop for graphical tools such as QGIS or MATLAB.
- **Software flavors**: exactly the software a course or project needs.
- **Courses linked to TUWEL**: enrolled students get access automatically, grades flow back.
- **Group servers** with real-time collaboration.
- **Shared materials and datasets**, read-only for students.
- **Autograded assignments** with our open-source [Grader Service](https://grader-service.readthedocs.io/en/latest/).
- **GPUs** for machine learning and other compute-heavy work, on request.

## Hands-on video

<video controls>
  <source src="https://colab.tuwien.ac.at/download/attachments/43127273/grader_service_demo.mp4?version=1&modificationDate=1751969837732&api=v2" type="video/mp4">
  Your browser does not support the video tag.
</video>

## Help and news

Most problems are solved by restarting your server; see [Troubleshooting](https://datalab.tuwien.ac.at/science/jaas/troubleshooting/).

- **Chat:** the [`#jupyter:tuwien.ac.at` room on Matrix](https://matrix.to/#/#jupyter:tuwien.ac.at)
- **Support ticket:** our [service portal](https://jira.it.tuwien.ac.at/servicedesk/customer/portal/7/create/97)
- **New features and maintenance windows:** the [mailing list](https://list.tuwien.ac.at/sympa/subscribe/jupyter)