sshspawner

The sshspawner enables JupyterHub to spawn single-user notebook servers on remote hosts over SSH. We provide this package as a reference implementation only, the authors offer no general user support.

Features

• Supports SSH key-based authentication
• Pool of remote hosts for spawning notebook servers
• Extensible custom load-balacing for remote host pool
• Remote-side scripting to return IP and port

Requirements

• Python 3
• JupyterHub
• AsyncSSH

Installation

python3 setup.py install

Install scripts/getport.py on remote host and set correct path for c.SSHSpawner.remoteportcommand in jupyterhubconfig.py

Configuration

See jupyterhub_config.py for a sample configuration. Adjust values for your installation.

License

All code is licensed under the terms of the revised BSD license.

Resources

• Documentation for JupyterHub
• Documentation for Project Jupyter | PDF
• Project Jupyter website