# Setting up a course or project

This section is for lecturers who run a course on JaaS and for researchers who set up a project for their team. You manage everything in the self-service portal at [jaas.datalab.tuwien.ac.at](https://jaas.datalab.tuwien.ac.at). Your students or team then work on the hub as described in [Getting started](https://datalab.tuwien.ac.at/science/jaas/getting-started/).

## What you set up

Everything belongs to a **workspace**: one course or one research project. Three places work together:

<div class="grid cards" markdown>

-   :material-cog: **Self-service portal**

    ---

    [jaas.datalab.tuwien.ac.at](https://jaas.datalab.tuwien.ac.at): you set up the workspace, its environments, members and groups.

-   :material-school: **TUWEL course**

    ---

    Sends the enrolled students to the portal and, through the JupyterHub activity, to the hub. Receives the grades.

-   :material-language-python: **JupyterHub**

    ---

    [hub.jaas.datalab.tuwien.ac.at](https://hub.jaas.datalab.tuwien.ac.at): where you and your students start servers and work.

</div>

| Part of the workspace | What it decides | Details |
|---|---|---|
| **Environments** | Software, memory, CPU and GPU of the servers | [Environments](https://datalab.tuwien.ac.at/science/jaas/instructors/environments/) |
| **Members** | Who has access, and who is lead or member | [Members and groups](https://datalab.tuwien.ac.at/science/jaas/instructors/members-and-groups/) |
| **Groups** | Teams that share one group server | [Members and groups](https://datalab.tuwien.ac.at/science/jaas/instructors/members-and-groups/#groups) |
| **Storage and datasets** | Quotas, shared materials, linked datasets | [Materials and grading](https://datalab.tuwien.ac.at/science/jaas/instructors/materials-and-grading/) |
| **LMS integration** | The link to your TUWEL course | [below](https://datalab.tuwien.ac.at/science/jaas/instructors/#setting-up-a-course) |

A workspace linked to a TUWEL course is a **course**: members are synced from TUWEL and assignments can be graded back into TUWEL. Without a link it is a **research workspace**, and you add members yourself.

## Setting up a course

!!! tip "Before you start"
    - Subscribe to the [mailing list](https://list.tuwien.ac.at/sympa/subscribe/jupyter) for new features and maintenance windows, and join the [Matrix room](https://matrix.to/#/#jupyter:tuwien.ac.at).
    - Add **Florian Jäger** and **Josef Taha** to your TUWEL course as LV-Leiter, so we can help quickly when something is off.

1. **Add the JupyterHub activity to your TUWEL course.** Students use it to reach the hub; their first visit through it connects them to your course.
2. **Create a workspace** in the [self-service portal](https://jaas.datalab.tuwien.ac.at) with **New Workspace**. Choose TUWEL as the LMS and your course, give the semester, and pick a first environment.
3. **Wait for approval, the first time only.** We review your first workspace. After that you are a trusted user and new workspaces are active immediately.
4. **Check the members.** Enrolled students are synced from TUWEL at regular intervals; the **Integration** tab has a button to sync right away.
5. **Adjust the rest**: [environments](https://datalab.tuwien.ac.at/science/jaas/instructors/environments/), [groups](https://datalab.tuwien.ac.at/science/jaas/instructors/members-and-groups/#groups), [materials](https://datalab.tuwien.ac.at/science/jaas/instructors/materials-and-grading/). Changes apply the next time a server starts.
6. **Try it yourself.** Open the hub through the TUWEL activity and choose **Start as: Student** to see what your students see.

## Setting up a research workspace

1. Create a workspace in the [self-service portal](https://jaas.datalab.tuwien.ac.at) without an LMS link.
2. Add members by their TU Wien e-mail address in the **Members** tab.
3. Members log in at [hub.jaas.datalab.tuwien.ac.at](https://hub.jaas.datalab.tuwien.ac.at) with **Sign in with dataLAB** or **Sign in with GitLab**.

Environments, groups, storage and datasets work as for a course.

## Courses on other Moodle instances

Courses on Moodle instances other than TUWEL, for example at partner universities, are set up by us. Send us:

- the URL of your course page,
- the software you need (see the [flavor catalog](https://datalab.tuwien.ac.at/science/jaas/software-flavors/#flavor-catalog)),
- memory and disk space per student, the number of students, and whether you need GPUs.

Add **Florian Jäger** and **Josef Taha** to the course as teachers.

## Need help?

- **Chat:** the [Matrix room](https://matrix.to/#/#jupyter:tuwien.ac.at)
- **Support ticket:** our [service portal](https://jira.it.tuwien.ac.at/servicedesk/customer/portal/7/create/97)
- **Contact:** Florian Jäger or Josef Taha
- **Announcements:** [subscribe](https://list.tuwien.ac.at/sympa/subscribe/jupyter) or [unsubscribe](https://list.tuwien.ac.at/sympa/signoff/jupyter) from the mailing list