Public | Automated Build

Last pushed: 2 years ago
Short Description
JupyterHub with Google OAuth.
Full Description


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 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!

Docker Pull Command