Introductory Material

Introduction to JupyterHub


Teaching: 15 min
Exercises: 0 min
  • What is JupyterHub?

  • learn about our overall computing framework for geohackweek

JupyterHub Access

The JupyterHub for GeohackWeek is accessible at:

You will need a Github account for authentication.

Jupyter Notebook

JupyterHub What Is

Here is an amazing slide deck about Jupyterhub: JupyterHub Thing Explainer

If you’re lazy, here is one slide:


JupyterHub for GeohackWeek

This is a conceptual graphic of our cloud-based JupyterHub environment for geohackweek:


Initial Setup

Paths and folders

Open a new Jupyter Notebook terminal.


If you type conda, you will get a conda usage guide:

usage: conda [-h] [-V] command ...

If you get “conda: command not found”, you will need to add the conda path to your bash profile by exporting the path: export PATH=/opt/anaconda/bin:$PATH

Next, we are going to clone the Git repository we will be using for the tutorials this week. You will need to clone this into the ‘notebooks’ folder in your home directory.

$ ls # check your present working directory and list available files and folders
$ cd notebooks # change directory to notebooks
$ pwd # check present working directory again, it should say something like /home/user/notebooks
$ git clone ''
$ ls # check that the folder is there


Notebooks and environments

  1. Return to the Jupyterhub home tab
  2. You should now see tutorial_contents as a folder
  3. We will test out setting environments for our notebooks.
    • Change directories to tutorial_contents > vector > notebooks
    • Select geopandas_advanced.ipynb
    • You will be prompted to select a kernel. Select the Vectorenv kernel.


Key Points