OAuthenticator

Example of running JupyterHub with GitHub OAuth for authentication.

setup

Edit the file called userlist to include one GitHub user name per line. If that user should be an admin (you!), add admin after a space.

For example:

mal admin
zoe admin
wash
inara admin
kaylee
jayne
simon
river

Build the container with:

docker build -t jupyter/oauthenticator .

To run the server on HTTPS, put your ssl key and cert in ssl/ssl.key and ssl/ssl.cert.

Add your oauth client id, client secret, and callback URL to the env file. Once you have built the container, you can run it with:

docker run -it -p 8000:8000 --env-file=env jupyter/oauthenticator

Which will run the Jupyter server.