Access JupyterHub

Questions

  • How do I log in to JupyterHub?
  • How do I access JupyterHub at Bowdoin?
  • What is the web address for Bowdoin's JupyterHub?
  • How do I start a Jupyter notebook server?
  • Why can't I reach JupyterHub from off campus?
  • How do I open my home directory in JupyterHub?
  • How do I start a new notebook in JupyterHub?
  • Should I use my email address or my login account to sign in to JupyterHub?

Environment

This article applies to Bowdoin students, faculty, and staff who use JupyterHub. JupyterHub is a multi-user hub that spawns, manages, and proxies multiple instances of the single-user Jupyter notebook server. It is used primarily to run R and Python, but can also run other software such as SageMath. Bowdoin's JupyterHub service is backed by the High Performance Computing (HPC) grid.

  • JupyterHub is available on the web at https://jupyter.bowdoin.edu.
  • Sign in with your Bowdoin login account, not your email address. For example, use jsmith, not jsmith@bowdoin.edu.
Off campus? You must connect to the Bowdoin VPN service before you can reach the JupyterHub web page. See Setting Up the VPN on Your Computer or iPad in the Related Articles section.

Resolution

  1. Using the web browser on your computer or iPad, go to https://jupyter.bowdoin.edu and log in with your Bowdoin login account. Do not type @bowdoin.edu after your login account. If your account is jsmith, type only jsmith with nothing after it.
  2. For most people, the Single CPU Notebook is adequate. If you need specialized HPC resources, click the down arrow and select the appropriate choice. Click the Spawn button when ready. This submits a job to the HPC grid to start your Jupyter notebook. This process can take 30 to 60 seconds.
  3. You may need to change to your home directory before you can run a notebook. Click the File menu in the upper left and select Open from Path. Type /home/accountname, where accountname is your Bowdoin login account. For example, if your login account is jsmith, type /home/jsmith. Click the blue Open button.
  4. To start a new notebook, click once on the appropriate notebook icon shown on the right-hand side of the page.

Additional Help

If you need further assistance, you have several options:

  • Bowdoin Bot: Chat with Bowdoin Bot directly from any KB page for instant answers.
  • Phone: Call the Bowdoin College Service Desk at (207) 725-3030.
  • In person: Visit the Tech Hub in Smith Union during business hours.
  • Submit a ticket: Request assistance through the Service Catalog.
Print Article

Related Articles (2)

Common problems and fixes for Bowdoin's JupyterHub service, including login errors, an unresponsive browser, the xsrf argument error, off-campus and Wi-Fi network requirements, and how to restart your notebook server. Applies to Bowdoin students, faculty, and staff who use JupyterHub.
How to download a Jupyter notebook or other file to an iPad in Safari and then upload it into JupyterHub, including how to remove a ".txt" ending that the iPad may add so the file will run. Applies to Bowdoin students, faculty, and staff using JupyterHub on an iPad.