JupyterHub: GitHub authentication

Logins to the jupyter instance of the OpenEarthscape JupyterHub are controlled through GitHub. It takes a little extra work to set this up, but afterward you won't have to remember a username + password to login.

To obtain a login, follow these steps.

  1. You must be a CSDMS member to use this Hub. Join CSDMS if you're interested in using community software to model earth and planetary surface processes.
  2. If you don't already have a GitHub account, sign up for one.
  3. Request authorization for your account through the CSDMS Help Desk. You should typically hear back in less than a day.

Once you're approved, sign in to the Hub.

The first-time login process

The first time you login, you'll be asked to authenticate through GitHub. Here are some screenshots of the process.

First, the login screen for https://jupyter.openearthscape.org. Click the "Sign in with GitHub" button.

Next, you'll be asked to provide your GitHub login credentials. If you've turned on two-factor authentication in GitHub, you'll also be asked to provide a code.

Finally, GitHub will ask you if it's OK to use your credentials to login to the OpenEarthscape JupyterHub.

These steps are only performed once. Afterward, GitHub will automatically log you in to the JupyterHub.