Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Step-by-Step: How to Get Started with JupyterHub

1. Open the Login Page (ENTRA ID)

  1. Go to the JupyterHub website

  2. Enter your CSUF campus email (e.g. tuffy@csu.fullerton.edu) and click Next

JupyterHub login page showing the email sign-in field
  1. Enter your password and click Sign in

Website's sign-in page showing the "Enter password" button

2. Sign in with DUO EAM

  • You’ll be redirected to a DUO EAM multi-factor authentication gateway.

  • Click Continue

  • Approve the login using your preferred verification method (e.g., push notification on your phone or a one-time passcode)

DUO EAM Verification Required page with Continue button

3. Permission Request

  • You’ll see a Permission Request page asking for access to your CSUF account.

  • Click Accept to authorize the JupyterHub service.

Microsoft permission request page asking to authorize JupyterHub access

4. Set Server Options

Once logged in, you’ll see the Server Options screen.

Here you can configure:

  • GPUs (optional; set to 1 if using GPU-enabled images)

  • Cores (e.g., 1, 2, or more depending on your job)

  • RAM (e.g., 4 for 4GB; leave blank for default)

  • GPU Type (optional)

  • Image this is your environment, such as: NRP Deep Learning & Data Science Full, PyTorch, SciPy, TensorFlow, R, Julia, etc.

5. Start Your Server

  • Once you’ve configured your environment, scroll down and click Start

  • This will launch your JupyterHub server. It may take up to a minute to initialize.

JupyterHub Server Options page showing environment selection dropdowns and the Start button

6. Start Coding!

Welcome to your workspace!

  • Open or create a .ipynb notebook

  • Write your code

  • Run

JupyterLab interface with file launcher options and active directory treeJupyter Notebook cell executing Python code and displaying printed results

7. Stop Server