JupyterHub with Google OAuth.
The idea is that all of the generic, reusable config lives in the ninjaben/jupyter-jub-oauth
Dockerfile.
Then all of the site-specific config, like SSL and users, goes in a separate deploy-helper
script and gets mounted into the Docker container at run time.
To do your own deployment, you'd copy the deploy-helper
, edit it with your own site-specific config, and run it. Or just use the deploy-helper
as documentation for how to work with ninjaben/jupyter-jub-oauth
. You do you!
Here are the site-specific configs you need:
- Google account email addresses for known users. At least one admin (you!).
- A domain name where you'll host your JupyterHub. You can use
lvh.me
to point back at localhost, which is great for testing. - OAuth web app Client Id and Client Secret obtained from your Google Developer Console.
- Your own SSL certificate and key. Or, the
deploy-helper
can self-sign one for you.
This image was inspired by the jupyterhub official oauthenticator example. Thanks!