GORG Jamboree

2023 Jamboree Website

Jupyterhub Setup

Getting started on the Jupyterhub

You all should have received a username and password for the course Hub.

To sign in, navigate to jupyterhub.bigelow.org in your browser and enter in your username and password to sign in.

You should now see what looks like a file system on the left, and a working environment on the right. This is your own personal file system within the larger jupyterhub set up for this course.

Setting up your home directory

There are a couple of things we need to do to get your system set up. First we want to link the storage directory to your home directory. To do this open up a terminal like this:

  1. click the plus in the upper-left corner of the hub
  2. under ‘Other’ select terminal to open up a terminal tab
  3. And then type:
$ ln -s /mnt/storage/ storage

This storage directory contains all of the data for the course as well as space for you to work. Shared course data can be found at:


Everyone can have their own working directory in the folder


Let’s navigate there now and create working directories for ourselves:

$ cd storage/user_lab
$ mkdir {your_username}

Consider this your workspace for the week. Feel free to copy data from the data directory into your own directories for you to look at.

Conda Environments

The jupyterhub is installed and managed with conda, so all rules for managing and finding conda environments apply within this hub. We have pre-installed several different environments.

Pre-installed environments can be found here:


And can be loaded as such:

conda activate storage/envs/gorgpy

The currently available environments are:
DRAM: source activate storage/envs/dram
DeepVirFinder: source activate storage/envs/dvf
VIBRANT: source activate storage/envs/vibrant
VirSorter2: source activate storage/envs/vs2
checkm2: source activate storage/envs/checkm2
CheckV: source activate storage/envs/checkv
gunc: source activate storage/envs/gunc
mamba: source activate storage/envs/mamba
mdmcleaner: source activate storage/envs/mdmcleaner
snakemake: source activate storage/envs/snakemake
gorgpy: source activate storage/envs/gorgpy
gorgr: source activate storage/envs/gorgr

Jupyter notebooks

Two of these environment maybe be used within jupyter notebooks: gorgR (an R kernel) and GORGpy (a python kernel). The gorgr notebook kernel (just called ‘R’ within the lab interface) has tidyverse packages pre-installed. The GORGpy kernel has data science packages such as pandas, numpy and matplotlib installed. You can select which kernel you’d prefer when starting a new Jupyter Notebook.

Feel free to install your own environments and software if you want to run your own analyses during the jamboree.

Getting data into and out of the Jupyterhub

To upload files, you can either drag-and-drop data from your desktop to your ‘hub file system, or you can use the upload up arrow in the upper left-hand portion of your ‘hub.

To download files from the hub to your computer, navigate to the file within the file tree on the left side of the hub, right-click the file and select ‘Download’.

Jupyter Notebook Demo

Located within this github repository

Last updated on 30 Apr 2023
Published on 30 Apr 2023