ninjaben/jupyter-hub-oauth repository overview

⁠jupyter-hub-oauth

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.

⁠Deployment

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.

⁠Thanks

This image was inspired by the jupyterhub official oauthenticator example⁠. Thanks!