Fork me on GitHub

7. JupyterHub: errors and troubleshooting

7.1. Common issues

7.1.1. After submitting Spawner options I get returned to the Spawner options page after a minute or two

The cluster is not able to start your JupyterHub session at this time because:

  • the cluster is currently doesn’t have the capacity to start your JupyterHub job on demand at this time or
  • you have requested an incompatible set of resources from the Spawner options form or
  • the job scheduler allocates you resources on cluster nodes but the Jupyter server software cannot start for some reason.

To determine if the third of these possibilities is the case check the most recent jupyterhub.oXXXXXX log file in your home directory for error messages.

7.1.2. I encounter errors when trying to create/modify environments via the Conda tab in Jupyter

This is a known issue that will hopefully be resolved in future. For now create and modify conda environments from the command-line.

7.2. I cannot browse to subdirectories below /data or /shared from the Jupyter file browser

This is a known issue; a workaround is described here.

7.3. Less common issues

7.3.1. I get a ‘503’ error after logging in to JupyterHub

If you modify the PYTHON_PATH variable in your .bashrc file your Jupyter server may not start correctly. The solution to this is to remove these lines from your .bashrc file.

Also,f you have previously tried installing and running Jupyter yourself (i.e. not using this JupyterHub interface) then you may get 503 errors when connecting to JupyterHub due to the old .jupyter profile in your home directory; if you then find a Jupyter log file in your home directory containing SSL WRONG_VERSION_NUMBER then try deleting (or renaming) the .jupyter directory in your home directory.