Draft

This documentation is in draft and under active review. Figures for the Fall 2026 GPU reservation system are not yet published, and some pages describe behaviour that has not been verified against a primary source. Check with us before relying on anything here.

Access

Three ways in — the browser, the shell, and a remote editor — and what to do when one of them will not let you in.


There is no eligibility requirement and nothing to request in order to move between them. Everything on this page is documented once and linked from wherever it is needed.

Every page in this directory is an initial draft. Each opens with a note naming what its writer could not settle. Please read those before treating any page as final.

Page Covers
Datahub in the Browser Signing in, picking a course and environment, and stopping a session.
The Login Node ssh, what belongs on dsmlp-login and what does not, and reaching a service through a tunnel.
Remote Editor Setup VS Code over Remote-SSH, against a container rather than the login node.
Sign-In & Session Problems The address, a missing course, a spawn failure, and a launch the cluster refuses.
When Access Starts & Ends Provisioning dates by population, retention, archiving and purge.

The Three Routes


Route Interface Best for
Browser datahub.ucsd.edu — Jupyter in a tab Coursework, assignments, anything that finishes in one sitting
Shell ssh to the login node, then a launch script Work that must outlive the connection, resource requests beyond the course menu, batch jobs
Remote editor VS Code, attached over SSH Editing a real codebase, with local extensions, against cluster hardware

The browser covers most coursework. It requires nothing installed, nothing configured, and no knowledge of Linux: signing in, selecting a course and selecting an environment produces a Jupyter session with the account's files in it. A session started from datahub.ucsd.edu expects the browser window to remain open while its work runs, and is not the route for work that continues unattended for hours. → Datahub in the Browser

The shell is the route for anything the course menu does not cover. Any one of these is sufficient reason, and none of them requires permission.

  • Work that must outlive the connection. Background and batch jobs are started from a terminal and keep running after a disconnect. → Working from the Command Line
  • Resources beyond the course menu — more CPU or RAM, or a GPU class the course's environments do not include. → GPU Access
  • Moving a lot of data. scp, sftp, rsync and git all run from the login node. → Moving & Sharing Data
  • Cleanup. A session that will not start because a disk quota is full or a pod is stuck is cleared from the shell rather than from the browser. → Sign-In & Session Problems

The shell begins at the login node, which is a jumpbox and not a machine for running work. → The Login Node

A remote editor suits a project that has outgrown a notebook. Editing across many files, with local extensions and a debugger, is served by VS Code attached over Remote-SSH, which runs a local editor against cluster hardware. It takes the most setup of the three, and closing the editor does not release the container. → Remote Editor Setup

What Does Not Change Between Them


Files. The login node and the container share a filesystem, and a home directory follows the account between routes. A file uploaded in the browser is on the login node; a file transferred with scp is in the notebook. → Directories, Quotas & Cleaning Up

Entitlements. The same workspace, the same quotas, the same GPU classes. The shell exposes more of them directly, but does not grant anything extra.

Concurrency. A member may have one Datahub session running, alongside any number of shell, VS Code and batch jobs. The ceiling that binds is the total CPU, memory and GPU across everything running at once. → One Datahub Session · Running Several Jobs at Once


← Documentation index