Skip to article frontmatterSkip to article content

JupyterHub

Why are we using a shared cloud environment?

We use JupyterHub in an educational setting because it enables us to quickly begin working with code. Each participant connects to a computational environment hosted in the cloud. All that is required is a web browser, and a GitHub username for authentication:

jupyterhub-connectivity

We encourage you to use these shared cloud environments for all the tutorials, and you can optionally use this for your projects as well.

How do I access the shared cloud environment?

Access to our shared cloud environment (JupyterHub) is under this URL: !

First time login

The first time you sign in, you will be asked to authorize the OAuth app as access to the JupyterHub is restricted to CryoCloud GitHub Organization members.

jupyterhub-authentication

After each login

jupyterhub-overview

When you log into JupyterHub you have access to your own virtual drive space under the /home/jovyan directory. No other users will be able to see or access your data files. You can add/remove/edit files in your virtual drive space.

How do I end my JupyterHub session?

Stopping the server happens automatically when you navigate to “File -> Log Out” and click “Log Out”! to end a session. You can also select “File -> Hub Control Panel -> Stop my Server”.

hub-control-panel-button

The reason for this is it will save us a bit of money! When you keep a session active it uses up AWS resources and keeps a series of virtual machines deployed.

Will I lose all of my work?

Logging out will NOT cause any files under /home/jovyan to be deleted. It is equivalent to turning off your desktop computer at the end of the day.