Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

πŸ” Configuring GitHub authentication

GitHub authentication on shared cloud infrastructure is complicated.

Always remember, β€œcloud” is the same as β€œsomeone else’s computer”. It’s not a good idea to store your credentials on someone else’s computer!

For this reason, we use a special tool called gh-scoped-creds to provide a special credential which grants restricted access to only certain GitHub resources for a limited amount of time.

Copy the GitHub authentication NotebookΒΆ

There’s a special notebook titled GHAUTH.ipynb in the shared/ directory.

Right-click it, select β€œCopy”, then return to your home directory by clicking the πŸ“ icon at the top of your file browser. Finally, right click in the empty space in your home directory and select β€œPaste”.

Follow the instructions in the NotebookΒΆ

The first time you use this Notebook, you should open the β€œFirst time setup” hint and follow the instructions within.

After you’ve completed first-time setup, run the code cell at the end of the Notebook and carefully follow the instructions output by this cell.

Granting permission for pushing to additional repositoryΒΆ

If you only granted access to one repository (recommended), you may want to add more later.

You can update the list of repositories you want to grant access to by visiting the configuration page for the CryoCloud GitHub application.