Log in to the JupyterHub

Start a server, find your files, and stop it when you are done.

Everything in this tutorial runs on a JupyterHub in the cloud. You do not need to install anything on your own computer.

WarningThe workshop hub is deleted a week after the hackathon

Everything on it goes: your home directory, the shared folders, and the scratch bucket. Before then, push your work to GitHub (Git and GitHub, with an agent), and download anything else you want to keep.

NoteYou will
  • Log in and start a server
  • Save your work before the hub is deleted
  • Know where your files live, and which folders are shared
  • Stop or restart your server

Start a server

  1. Go to https://workshop.nmfs-openscapes.2i2c.cloud/.

  2. Log in. Your username is your email address. The organizers give you the password in person or by direct message; everyone uses the same one. Do not post it anywhere public, including GitHub.

  3. Image: choose Other, then paste this into the Custom image box:

    ghcr.io/nmfs-opensci/py-rocket-geospatial-2:2026.11.17
  4. Size: pick the smallest machine. That is plenty for everything here. Larger machines cost more, so choose one only if you run out of memory.

    The machine size drop-down

  5. Click Start. It can take a few minutes to start.

When it is ready you land in JupyterLab, on the Launcher. Next: Find your way around JupyterLab.

Your files

  • /home/jovyan is your home directory. Everyone’s home is called /home/jovyan (that is the Jupyter default), but yours is private, and it persists between sessions.
  • shared/ is read-only, with files the organizers have put there for you.
  • shared-public/ is read-write and visible to everyone. Make a team folder there. Agree with your team who edits what, because anyone can change anything in it.

The shared folders in the file browser

Stop your server

When you are done for the day, stop your server. It shuts down after 90 minutes idle anyway, but a running server costs money. Stopping does not delete your work. It is like turning off your computer.

From the JupyterLab tab, choose one of these:

  • File → Log Out
  • File → Hub Control Panel → Stop My Server
Tip

If the server crashes

This can happen when many people use a lot of memory at once. Go to File → Hub Control Panel, click Stop My Server, then Start My Server. You will not lose work, unless you were in the middle of uploading a file.

Getting help

Adapted from NMFS HackDays 2025: Intro to JupyterHubs.