cloudsshspawner

The cloudsshspawner enables JupyterHub to spawn single-user notebook servers on remote hosts over SSH.

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.6 - 3.9
[JupyterHub](http://jupyter.org/install)
[AsyncSSH](https://asyncssh.readthedocs.io/en/latest/#installation)

Installation

The cloudsshspawner is installed with the following command:

pip3 install .

Install [scripts/get_port.py](scripts/get_port.py) on remote host and set correct path for c.CloudSSHSpawner.remote_port_command in [jupyterhub_config.py](jupyterhub_config.py)

Configuration

See [jupyterhub_config.py](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.

Credit

Based on the reference implementation by the NERSC [CloudSSHSpawner](https://github.com/NERSC/cloudsshspawner)

Resources

[Documentation for JupyterHub](https://jupyterhub.readthedocs.io)
[Documentation for Project Jupyter](https://jupyter.readthedocs.io/en/latest/index.html) | [PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)
[Project Jupyter website](https://jupyter.org)

rasmunk/cloudsshspawner