JupyterHub deployment in use at Université de Versailles
- Containerized single user Jupyter servers, using DockerSpawner;
- Central authentication to the University CAS server;
- User data persistence;
- HTTPS proxy.
This deployment is described in depth in this blog post.
Adapt to your needs
This deployment is ready to clone and roll on your own server. Read the blog post first, to be sure you understand the configuration.
Then, if you like, clone this repository and apply (at least) the following changes:
.env, set the variable
HOSTto the name of the server you intend to host your deployment on.
reverse-proxy/traefik.toml, edit the paths in
keyFileand point them to your own TLS certificates. Possibly edit the
volumessection in the
jupyterhub/jupyterhub_config.py, edit the "Authenticator" section according to your institution authentication server. If in doubt, read here.
Other changes you may like to make:
jupyterlab/Dockerfileto include the software you like. Do not forget to change
jupyterhub/jupyterhub_config.pyaccordingly, in particular the "user data persistence" section.
Once you are ready, build and launch the application with
docker-compose build docker-compose up -d
Read the Docker Compose manual to learn how to manage your application.
Work partially funded by OpenDreamKit.