Skip to main content

Source repo: basic_skills | Branch: hpc-training-doc | Last synced: 2026-04-24 10:27:17.425 UTC

Using Jupyter Notebooks on the SDSC Expanse Cluster

Overview​

This quick-start guide will show you how to run Jupyter notebooks on Expanse using the Satellite Reverse Proxy Service.

Satellite is a prototype system that allows users to launch secure (HTTPS) Jupyter services on Expanse compute nodes using a simple bash script such as galyleo or start_notebook. The notebooks are made available outside the cluster firewall using a secure HTTPS connection between your web browser and the reverse proxy server.

Contents​

Using the galyleo script​

galyleo is a shell utility that helps you launch Jupyter notebooks on high-performance computing (HPC) systems in a simple and secure way.

It works with the Satellite reverse proxy service and a batch job scheduler such as Slurm to provide each Jupyter notebook server with its own one-time, token-authenticated HTTPS connection between the compute node and your web browser.

This HTTPS-secured connection provides privacy and integrity for the data exchanged between the notebook server and your browser, helping protect your work against network eavesdropping and data tampering.

note

For full usage details, see the galyleo repository:
https://github.com/mkandes/galyleo

Running CONDA Environments and Jupyter Notebook on Expanse​

For a detailed walkthrough on using CONDA environments with Jupyter on Expanse, see the CIML Summer Institute material:

Example Notebooks​

Clone the notebook example repository, or use one you have already created:

git clone https://github.com/sdsc-hpc-training-org/notebook-examples-expanse.git

Once cloned, you can launch a secure notebook using the galyleo command.

Last updated: April 24, 2024
Author: Mary Thomas, SDSC