@@ -8,6 +8,20 @@ Before being able to work with the JupyterHub you will need an account on the KI
To login to the cpu node first connect to the TU Braunschweig VPN and go to https://ki4allcpu.irmb.bau.tu-bs.de/ in your browser. You should be prompted to a login window where you will be asked for username and password. Both will be the same as the credentials you use for the SSO login, e.g., in stud.IP.
### Environments
### Python Environments
After the login, you will be prompted to a dropdown menu, where you can select certain docker containers. Currently, it is recommended to start with the base container. If for any reason you need a different container, please first build the container yourself and afterwards provide a Dockerfile to Marvin Klingner [m.klingner@tu-braunschweig.de](mailto:m.klingner@tu-braunschweig.de).
After the login, you will be prompted to a dropdown menu, where you can select certain docker images. Currently, it is recommended to start with the base image. If for any reason you need a different image, please first build the image yourself and afterwards provide a Dockerfile to Marvin Klingner [m.klingner@tu-braunschweig.de](mailto:m.klingner@tu-braunschweig.de). He will need to add certain JupyterHub-specific packages. At a later point in time a general template will be provided.
### User Environment
Each user has a jupyter server in a self-contained docker image. Accordingly, each user in the JupyterHub has only limited access to the base server and very limited possibilities to interact with other users. The docker image mounts certain directories such as the user's home directory from the base system. Per default currently the following directories are mounted:
- The /home/{$USERNAME} directory with the user's data
- The /work/exchange/ directory to enable data exchange via nbgrader
- The /work/datasets/ directory to enable shared dataset usage without user-specific copies
- The /work/results/ directory to allow users to save data intended for data exchange with other users
If you need further directories to be mounted, please discuss with Marvin Klingner [m.klingner@tu-braunschweig.de](mailto:m.klingner@tu-braunschweig.de)
### NbGrader
The nbgrader package provides many functionalities to teach practical programming courses with automated testing and feedback. The nbgrader package with jupyterlab is installed in the base docker image. You can use it freely according to the official instructions [https://nbgrader.readthedocs.io/](https://nbgrader.readthedocs.io/). If you have specific questions, feel free to approach Marvin Klingner [m.klingner@tu-braunschweig.de](mailto:m.klingner@tu-braunschweig.de).
