Spawn user-specified Singularity containers with JupyterHub.

To install Singularity Spawner via Pip:

pip install jupyterhub-singularity-spawner

To install Singularity Spawner, clone the repo and do an editable pip install in your JupyterHub environment:

git clone https://github.com/ResearchComputing/jupyterhub-singularity-spawner.git
cd jupyterhub-singularity-spawner
pip install -e .

A basic configuration for Singularity Spawner (in the JupyterHub config file):

c.JupyterHub.spawner_class = 'singularityspawner.SingularitySpawner'
c.SingularitySpawner.default_image_url = "docker://jupyter/base-notebook"
c.SingularitySpawner.default_image_path = "/home/{username}/singularity/jupyter.img"

Jupyter Docker Stacks can be used as a base for building custom notebook environments run in Singularity containers.