Accessing Jupyterhub and JupyterLab

Description

JupyterHub is a multi-user Hub which spawns, manages, and proxies multiple instances of the single-user Jupyter notebook server. Primarily used to run R and Python software, but can be used to run other software such as SageMath. Bowdoin's Jupyterhub service is backed by the High Performance Computing (HPC) Grid.

  • Bowdoin offers two Jupyterhub services, one with the traditional Jupyterhub interface, and one with the JupyterLab interface
  • Please note that the login page for both look identical. The different interface will be seen after you login.
  • Use your Bowdoin login account, not your email address, to login to Jupyterhub/JupyterLab. For example, "jsmith", not "jsmith@bowdoin.edu" .

How to Login

If you are off campus, you will need to connect to the Bowdoin VPN service before you can access the Jupyterhub web page. Please refer to the knowledgebase article for information about setting up the VPN on your computer/iPad.

  1. To access JupyterHub, use the web browser on your computer or iPad to go to "https://jupyter.bowdoin.edu" or for JupyterLab go to "https://jupyterlab.bowdoin.edu" and login with your Bowdoin login account. Note, do not type "@bowdoin.edu" after your login account. If your account is "jsmith", then just type "jsmith" with nothing after it.
     
  2. For most, the Single CPU Notebook should be adequate. If you have need of some of the specialized HPC resources, you can click the down arrow and select the appropriate choice. Click the "Spawn" button when ready. This will submit a job to the HPC Grid to start your Jupyter notebook. Note that this process can take 30 to 60 seconds.
     
  3. If you are using the traditional Jupyterhub interface, you should then be presented with a view of the files and sub-directories in your Linux home directory. You can navigate through the directories by clicking on them.
     
  4. If you are using the JupyterLab interface, you need to change to your home directory before you can run a notebook. Click on the File menu in the upper left, and select Open from Path. Type in /home/accountname where "accountname" is your Bowdoin login account. For example, if your login account is "jsmith", you would type in /home/jsmith. Click the blue Open button.
     
  5. To start a new notebook using the traditional Jupyterhub interface, click on the New button in the upper right and select from the list of options (R, Python, etc). In the JupyterLab interface, click once on the appropriate notebook icon shown on the right hand side of the page.

Details

Article ID: 114682
Created
Tue 8/25/20 11:59 AM
Modified
Wed 9/16/20 5:04 PM
Platform Environment (OS)
Any