Ctrl+K

Demo JupyterHub

Demo JupyterHub#

Tutorial Lead: Eli Holmes (NOAA Fisheries)

Summary#

This tutorial will show you how to use the basic features of the JupyterHub.

Learning Objectives#

In this notebok you will learn:

  • How to start a server in the JupyterHub

  • The basic hub tools and navigation

Contents#

  1. Start a server

  2. Shutting down your JupyterHub

  3. References

Start a server#

  1. Scroll through the server sizes. Stick with the 2 Gb server (the default).

Tip

The amount of memory (RAM) you select, you are guaranteed, but if you use more you risk crashing your server. If you crash the server, it just requires re-running your code from the start (or perhaps restarting your kernel).

Most users require only 2 Gb of memory, like while we develop code, so consider using 2 Gb for most of your work and then switching over to a larger computer when you want to start running things.

Check your memory usage at the bottom in the middle of the screen.

  1. You can choose different images. Stick with the default Py-R Geospatial image.

  2. Once you are on the hub, let’s go over

    • JupyterHub options and viewing setup

    • Git and Github

    • Viewing and editing of different files

Now after the demo…

Shutting down your JupyterHub#

TIP

Best Practice: Shut down your server when you are done to save us money.

If you only close your tab or click log out, your server will continue running for 90 minutes.

Whenever you are done, it is best to shut down your server. Time on the JupyterHub costs money and there are systems in place to make sure your server doesn’t run indefinitely if you forget about it. After 90 minutes of no use, it will shut down. We prefer you shut down the server when so we save that 90 minutes of computing cost. To do so:

  • In upper left, click on File > Hub Control Panel, which will open another tab

  • Click the Stop Server button. Once this button disappears after you clicked it, your server is off.

  • Click Log Out in the top right of your screen and you will be logged out, or you can start a new server

  • You can now close this tab and the other tab where you were just working

Finishing up#

🎉 Congratulations! You’ve completed this tutorial and have seen how we can access and use the JupyterHub.

Contents