This is a JupyterHub deployment based on Docker currently in use at Université de Versailles.
This deployment is described in depth in this blog post.
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 HOST
to the name of the server you
intend to host your deployment on.reverse-proxy/traefik.toml
, edit
the paths in certFile
and keyFile
and point them to your own TLS
certificates. Possibly edit the volumes
section in the
reverse-proyx
service in
docker-compose.yml
.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/Dockerfile
to include the
software you like. Do not forget to change
jupyterhub/jupyterhub_config.py
accordingly, 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 the EU H2020 project OpenDreamKit.