JupyterHub + Dockerspawner + Named server + Multiple images

README.md

Local JupyterHub with DockerSpawner and multiple images

A test config for running JupyterHub locally with:

• DockerSpawner as a spawner
• named servers enabled

Setup

docker pull jupyter/scipy-notebook
docker pull jupyter/r-notebook

conda create -n jhub-local-docker -c conda-forge jupyterhub dockerspawner jupyter_client
conda activate jhub-local-docker

python -m jupyterhub -f jupyterhub_config.py --debug

jupyterhub_config.py

c = get_config()  # noqa

import os

from jupyterhub.auth import DummyAuthenticator
from dockerspawner import DockerSpawner

from jupyter_client.localinterfaces import public_ips

c.JupyterHub.hub_ip = public_ips()[0]
c.JupyterHub.allow_named_servers = True

c.JupyterHub.authenticator_class = DummyAuthenticator


images = {
    'python': 'jupyter/scipy-notebook',
    'r': 'jupyter/r-notebook',
}

class CustomSpawner(DockerSpawner):

    def start(self):
        self.image = images.get(self.name, images['python'])
        return super().start()


c.CustomSpawner.default_url = '/lab'
c.CustomSpawner.remove = True
c.CustomSpawner.name_template = "{prefix}-{username}-{imagename}-{servername}"

# uncomment to show the image dropdown
# c.CustomSpawner.image_whitelist = images

c.JupyterHub.spawner_class = CustomSpawner