Jupyter Notebooks are documents which can combine executable code, formatted text, and interactive graphics into a single file. Because Notebooks can be shared, they provide developers with a tool for capturing and explaining their computational results. To use a Jupyter Notebook, a web application, such as JupyterLab, is needed.
We now provide a web portal where JupyterLab can be accessed on Rivanna.
However, to use JupyterLab, you must have an account on Rivanna.
To access JupyterLab, you will begin by connecting to our Open OnDemand portal:
- Open a web browser and go to https://rivanna-portal.hpc.virginia.edu.
- Use your
Netbadgecredentials to log in.
- On the top right of the menu bar of the Open OnDemand dashboard, click on
- In the drop-down box, click on
Requesting an Instance
Your instance (or copy) of JupyterLab will run on a Rivanna compute node. So it will need a list of resources, such as partition, time, and allocation. If you are new to Rivanna, you may want to read the Rivanna User Guide to learn more about the partitions.
- After connecting to JupyterLab through Open OnDemand, a form will appear where you can fill in the resources for JupyterLab.
- When done filling in the resources, click on the blue “Launch” button at the bottom of the form.
- It will take a few minutes for the system to gather the resources for your instance of JupyterLab. When the resources are ready a
Connect to Jupyterbutton will appear. Click on the button and the Notebook session will open in a new tab.
The JupyterLab dashboard will have two panes:
- A file browser pane on the left where you will see the files and folders in your Rivanna directory; and
Launcherpane on the right with tiles for the available kernels (i.e., underlying software that will run the code in your Notebooks).
If you already have a Jupyter Notebook in your account, you can maneuver to the file in the file-browser pane, and double-click on the file name to open the Notebook.
However, if you want to create a new Notebook, go to the Launcher pane and click on the tile for the desired kernel (e.g., Python 3).
If you are more familiar with the classic Notebook environment, you can change the JupyterLab format by clicking on
Help and select
Launch Classic Notebook.
Custom JupyterLab Kernels
You may notice that the number or type of tiles on the Launcher differs between your account and a colleague’s account. If you have created conda environments with the
ipykernel package installed, those environments will appear as separate, specialized kernels labeled
Python [conda env:<ENV_NAME>]. You may need to hover over a tile to see the name of the environment.