JupyterHub demo
These are the setup scripts for a demo deployment of JupyterHub, using GitHub OAuth and Docker spawning. It is currently running at https://demohub.jupyter.org
Clone and install JupyterHub and dependencies
git clone https://github.com/jupyter/jupyterhub-demo /srv/jupyterhub
cd /srv/jupyterhub
make install
Configure your deployment
-
write
userlist, in the form:mal admin zoe admin inara admin wash kaylee jayne book simon riverAdmin users will have admin access to the JupyterHub instance. See
userlist.examplefor an example. -
set up GitHub OAuth and put the variables in
env. Seeenv.examplefor an example. TheOAUTH_CALLBACK_URLwill want to be of the formhttps://YOURDOMAIN/hub/oauth_callback -
add your ssl cert and key in
ssl/ssl.crtandssl/ssl.key, respectively. -
edit docker/Dockerfile as appropriate, then:
make build -
edit
jupyterhub_config.pyas appropriate
Start and stop JupyterHub
This sets up JupyterHub with supervisor, so you use supervisorctl to stop and start the service:
supervisorctl start jupyterhub
See supervisor docs for details on managing services.