JupyterHub Support

 In January 2023, Academic, Research and Collaborative technologies (ARC) launched datatools.utoronto.ca, an improved and simplified landing page for U of T’s educational JupyterHub. From this page, you can access all of our JupyterHub services in one central place. Learn more about the changes we’ve made to our JupyterHub on the in this announcement 

For technical support, please submit a ticket to our service desk via the Enterprise Service Centre. 

Welcome to the University of Toronto JupyterHub Support site. 

The University’s 2i2c JupyterHub is an open source, web-based platform. It offers a standardized computing environment without burdening users with installation and maintenance tasks. Users – including students, researchers and data scientists – can get their work done in their own workspaces on shared resources that can be managed efficiently by system administrators. It can be accessed via a web browser. 

Get started with JupyterHub 

Ready to start using JupyterHub? Access our landing page at datatools.utoronto.ca and select one of the listed services: Jupyter Notebook, RStudio and JupyterLab. Please note that as of January 2024, Jupyter Notebook maintains a Python environment only. R users should select RStudio. 

Resources for new users 

Access the Getting Started Guide for an overview of JupyterHub and using notebooks with Python. For an overview of using JupyterHub with R, please access this guide: R in JupyterHub. 

Get support 

Need additional support? Please us with any questions not addressed by the FAQs below by submitting a ticket through the IT Service Centre: Get JupyterHub help. 

JupyterHub FAQs for Python Users

How to create a new notebook?

  1. Navigate to ‘Files’ tab on Home page. 
  2. Click ‘New▼’ drop-down button.
  3. Select the programming language.
  4. A new notebook will be created in the current directory and opened in a new tab.
  5. Click on the ‘untitled’ in the title bar to rename the file.
How to create a folder?

  1. Navigate to ‘Files’ tab on Home page. 
  2. Click ‘New▼’ drop-down button.
  3. Select the ‘Folder’ option.
  4. A new folder will be created in the current directory and named ‘Untitled Folder’.
How to create a text file?

  1. Navigate to ‘Files’ tab on Home page.
  2. Click ‘New▼’ drop-down button.
  3. Select the ‘Text File’ option.
  4. A new text file will be created in the current directory and opened in a new tab.
  5. Click on the ‘untitled.txt’ in the title bar to rename the file.
How to open a terminal?

  1. Navigate to ‘Files’ tab on Home page. 
  2. Click ‘New▼’ drop-down button.
  3. Select the ‘Terminal’ option.
  4. A new terminal will be opened in a new tab.
How to delete files/folders?

A folder must be empty before it can be deleted.

  1. Select a file/folder by clicking on checkbox on the left.
  2. Relevant options will appear at the top.
  3. Click on the bin icon.
  4. Confirm the action to delete a file/folder by clicking on the ‘Delete’ button.
  5. Multiple files can be deleted at once by selecting them all at once in the step 1.
How to move files/folders?

A running notebook must be shutdown before it can be moved.

  1. Select a file/folder by clicking on the checkbox on the left.
  2. Relevant options will appear at the top.
  3. Click on the ‘Move’ button.
  4. Provide the path of the destination folder in the dialogue box.
  5. Click the ‘Move’ button to complete the action.
How to copy/duplicate files?

  1. Select a file by clicking on the checkbox on the left.
  2. Relevant options will appear at the top.
  3. Click on the ‘Duplicate’ button.
  4. Confirm the action by clicking on the ‘Duplicate’ button.
  5. A duplicate file will be created with ‘{filename}-Copy1’.
How to rename a file/folder?

  1. Select a file/folder by clicking on the checkbox on the left.
  2. Relevant options will appear at the top.
  3. Click on the ‘Rename’ button.
  4. Write a new name in the dialogue box.
  5. Click the ‘Rename’ button to complete the action.

Currently open file can be renamed by clicking on the file name in the title bar and following steps 4 and 5 from above.

How to download files from JupyterHub?

  1. Select a file/files by clicking checkbox on the left.
  2. Relevant options will appear at the top.
  3. Click on the ‘Download’ button.
  4. A download will begin. The file will be saved at a location specified or the default download location.
  5. The downloaded notebook will be an .ipynb file.
How to upload files to JupyterHub?
  1. Click on the ‘Upload’ button on the home page.
  2. A file picker will open.
  3. Select the file from your computer and Click ‘Open’ button.
  4. A file name with options to confirm or cancel the upload action will appear in the first row.
  5. Click the ‘Upload’ button to confirm.

 

How to export notebook as .PDF/.py/.md?

  1. Open a notebook you want to export.
  2. Click on the ‘File’ menu button. File options will appear.
  3. Click on ‘Download as’ to see file options.
  4. Select the appropriate file extension.
  5. A download of exported file will begin shortly.
  6. The file will be saved at a location specified or the default download location.
 

JupyterHub FAQs for R Users

How to create a new file?

  1. Navigate to the ‘File’ tab on the top-right
  2. Select the ‘New file’ button
  3. Select the type of file such as (R Script, R Markdown)
  4. A new (untitled) file will be created in the current directory and opened in a new tab
  5. Select the save current document button to save and change you file name.
How to create a new project?

  1. Navigate to the ‘File’ tab on the top-right
  2. click the ‘New Project‘ button
  3. Choose to create a project in existing directory or New directory
  4. Then choose the folder you want to store it project.
  5. A new project will be created in the current directory
How to create a text file?

  1. Navigate to the ‘File’ tab on the top-right
  2. Click the ‘New file ‘ button
  3. Select the text file
  4. A new (untitled) text file will be created in the current directory and opened in a new tab
  5. Click the save current document button to save and change you file name.
How to move files/folders?

In R studio:

  1. Navigate to the “Files” tab in the bottom-left panel
  2. Select a file by clicking on the checkbox on the left
  3. Click the “More” button
  4. Select the “move” and click
  5. Then select destination folder
  6. Click “Yes” to finish move or “No” to cancel this action.

 

How to delete files/folders?

  1. Navigate to the “Files” tab in the bottom left panel
  2. Select a file by clicking on the checkbox on the left
  3. Click the “Delete” button
  4. Click “Yes” to finish or “No” to cancel this action.
How to copy/duplicate files?

In R studio:

  1. Navigate to the “Files” tab in the bottom left panel
  2. Select a file by clicking on the checkbox on the left
  3. Click the “More” button
  4. Select the “copy” and click
  5. Default, the copied file is named as “Copyof{filename}”, you can change the file name
  6. Click “OK” to finish move or “Cancel” to cancel this action.
How to export rmarkdown as .PDF/.HTML/.Word?

  1. Click the ‘Knit’ button on the top
  2. Select the file type (Knit to HTML, Knit to PDF, Knit to Word)
  3. Wait until a new window show you the exported file.
  4. Click the download button on the top-left to down the exported file.
How to upload files to JupyterHub?

In R studio:

  1. Navigate to the “Upload” button on the bottom-left panel and click
  2. Click the “Choose File” button
  3. Select the file you want to upload from your computer
  4. Click the “OK” to finish or “No” to cancel this action
How to download files?

In R studio:

  1. Select a file by clicking on the checkbox on the left
  2. Click the “More” button
  3. Select the “Export” and click
  4. Click “Download” to download the file to you computer
How to rename a file/folder?

In R studio:

  1. Navigate to the ‘file’ tab on the top-right
  2. Click the ‘Rename’ button
  3. Write a new name
  4. Click the ‘OK’ button to finish this action

Copy the file to your folder:

  1. Open the link, attend to R studio
  2. Select a file by clicking on the checkbox on the left
  3. Click the “More” button
  4. Select the “Copy to” and click
  5. Then select destination folder
  6. Click “Yes” to finish move

Download the file:

  1. Select a file by clicking on the checkbox on the left
  2. Click the “More” button
  3. Select the “Export” and click
  4. Click “Download” to download the file to you computer