This page outlines common issues and troubleshooting steps for users of our Jupyter as a Service system.

For general issues with the JupyterLab interface, please check out the official documentation here.

For general issues with Grader Service, please checkout the official documentation here.

If you do not find your issue listed here, please submit a request through our ticketing portal!

Common requests and issues:

I have successfully logged in, but I get the error message: "Grader Labextension Disabled"

Possible Causes:

  • The error likely indicates that the API token used by the Grader Service in your JupyterHub server is invalid.

Solution:

  • Restart your JupyterHub server by following these steps:
    1. In the JupyterHub interface, go to File > Hub Control Panel.
    2. Select Stop My Server to shut down your current server.
    3. Log out in the Hub Control Panel.
    4. Log in again using your Moodle course.
  • This should refresh the API token and re-establish the connection to the Grader Service. If the issue persists after restarting, submit a ticket for further assistance.

I have created a conda environment, but after a server restart it does not exist anymore.

Cause:

  • We only persist data in the home directory. By default, conda creates environments in /opt/conda, which is not a persistent directory in our JupyterHub setup.

Solution:

  • Create the conda environment in your home directory by specifying the location. You can do this using the following command: 
    conda create --prefix ~/my_env_name
    conda create --prefix ~/my_env_name


  • This ensures that your environment is stored in your home directory and will persist across server restarts.

I am an instructor and I want to see the student view.

Solution: To view the JupyterHub from a student's perspective, follow these steps:

  • Log out of your current JupyterHub session.
  • In your TUWEL course, switch your role to "Student."
  • Access the JupyterHub via the course widget while in the student role.
  • To switch back to your instructor view, log out of JupyterHub, revert your role back to "Instructor" in TUWEL, and access JupyterHub again via the widget.

I have logged in, but I do not see my course as a server spawn option.

Explanation and Possible Causes:

  • The system associates users with specific courses through LTI configuration.
  • You may have logged in through a previous or different course, which is why your current course is not showing up.

Solution:

  • Log out of JupyterHub.
  • Navigate to the correct TUWEL course and access JupyterHub through the course's specific widget.
  • This ensures that you are accessing the right JupyterHub instance associated with the course.

I am part of multiple courses, but I do not find all courses in my server spawn list.

Explanation:

  • JupyterHub currently requires separate logins for each course.
  • This is because the system uses LTI integration to link your JupyterHub account to the course you are accessing.

Solution:

  • To see the server for a specific course, you need to log out and log in again via the respective course's JupyterHub widget:
    • Restart your JupyterHub server by following these steps:
      1. In the JupyterHub interface, go to File > Hub Control Panel.
      2. Select Stop My Server to shut down your current server
      3. Log out in the Hub Control Panel.
      4. Log in again using your Moodle course.
  • If you have multiple courses, repeat this process for each course to access their respective JupyterHub instances.

I was disconnected or my server stopped running unexpectedly.

Possible Causes:

  • Idle timeouts: JupyterHub servers are configured to automatically shut down after a period of inactivity.
  • Server issues or resource constraints.

Solution:

  • Simply log back into JupyterHub and start your server again.
  • If the server repeatedly shuts down or you experience disconnections while actively working, report the issue via the ticketing portal.

I need to reset my server or environment - how do I do that?

Solution:

  • If your JupyterHub environment becomes unresponsive or you encounter persistent issues, you may reset your server.
  • To reset:
    1. Stop your current server by selecting the "Control Panel" and then "Stop My Server."
    2. After the server stops, start it again from the "Spawn" menu.
    • Warning: Resetting the server will stop any running processes, but your files should remain intact.
  • If the environment issues persist after restarting, contact support.
  • No labels