Jupyter Notebook

You must setup your own Python environment and Jupyter installation to use Jupyter Notebook.

Python setup

  • Go to https://www.python.org/downloads/source/
  • Choose the “gzipped source tarball” for the Python release you want and copy the link location to be used with the wget command below
  • ssh to phoenix and perform the following commands to compile and install Python:
  • cd
    mkdir python3
    cd python3
    wget https://www.python.org/ftp/python/3.10.5/Python-3.10.5.tgz (or your preferring version from the link you copied above)
    tar xzvf Python-3.10.5.tgz
    cd Python-3.10.5
    ./configure --prefix=/home/YOURUSERNAME/python3/ --with-openssl=/usr/local/openssl11
    make install

Installing Jupyter

  • Use the following 2 commands to use your Python environment:
  • export PATH=/home/YOURUSERNAME/python3/bin:$PATH
    export PYTHONPATH=/home/YOURUSERNAME/python3

  • Use the following 2 commands to install Jupyter:
  • pip3 install jupyter
    jupyter notebook --generate-config

  • edit /home/YOURUSERNAME/.jupyter/jupyter_notebook_config.py and add the following line to end of the file:
  • c.NotebookApp.ip = '*'

Submitting a Jupyter Notebook job

  • Type qjupyter at the command line and answer the questions. An example is given below.
  • [user@phoenix ~]$ qjupyter
    This script will submit a Jupyter Notebook job.
    You will need to setup your own Python environment and Jupyter installation.
    Please see https://hpc.chem.wisc.edu/software/phoenix-software/jupyter-notebook/ for details.
    Press Ctrl-C at any time to quit without job submission.
    Please provide a job name:
    How many cores do you wish to allocate to this job?
    Which queue do you wish to use? (enter for default)
    Please enter your Python Path:
    Submitting your job named notebook1 to the default queue using 4 cores with a PYTHONPATH of
    Proceed? (y/n)
    Please check notebook1.log in your home directory for compute node name and URL info.

Setup SSH tunnel to connect to Jupyter

  • Look in the JOBNAME.log file in your home directory for the last few lines, similar to:
  • To access the notebook, open this file in a browser:
        Or copy and paste one of these URLs:
  • Take note of the name of the compute node starting with compute- and the line starting with
  • Following instructions for your operating system below:
  • Enter the following at the command-line on your local machine, where compute-0-0 is the compute node name from the step above:
  • ssh -L 8888:compute-0-0:8888 phoenix.chem.wisc.edu

  • Enter your username and password.
  • Run PuTTY and enter phoenix.chem.wisc.edu the Hostname box of the main Session window.


    • Under the Connection section, navigate to SSH and then Tunnels.
    • Enter 8888 in the Source port box.
    • Enter compute-0-0:8888 in the Desination box, where compute-0-0 is the compute node name from the step above.
    • Click Add.

    ssh tunnel

    • Click Open and enter your username and password.
  • Open a browser on your local machine and enter the line from the JOBNAME.log file that started with, including the token hash.

jupyter notebook

  • You can close the browser window and your job will continue to run and use resources. You will need to click the Quit button in the web interface or delete the job using the qdel command to stop it from running.