SSH Access

You can connect to your notebook environment via SSH — for example, to use VS Code Remote-SSH or PyCharm from your laptop.

Enabling SSH AccessCopy Anchor Link

1. Spawn a server using the Minimal NB with SSH access image, and switch on the Ensure SSH access into the notebook toggle in the spawn form (Step 1: Environment Options).
2. Copy the SSH address shown during startup — it has the form jovyan@jupyter-<username>--<server-name>.dyn.cloud.e-infra.cz (note the double dash between username and server name) — it will not be shown in the UI again. The address appears in the spawn progress page’s Event log. (If you lose it, run kubectl get svc -n jupyterhub-[yourlogin]-prod-ns -o yaml | grep external-dns.alpha.kubernetes.io/hostname inside the notebook, or reconstruct it from the pattern above).
3. Inside the JupyterLab terminal, add your laptop’s public SSH key to /home/jovyan/.ssh/authorized_keys:

   Copy Text

   mkdir -p ~/.ssh
   echo "ssh-rsa AAAA...your-public-key..." >> ~/.ssh/authorized_keys

If you don’t have an SSH key-pair generated on your laptop, you can create one with ssh-keygen -b 4096 -t rsa. The keys will be saved in [HOME]/.ssh/id_rsa (private part) and [HOME]/.ssh/id_rsa.pub (public part). Note that ls does not display dotfiles — use ls -a to see the .ssh directory.

4. Verify that the sshd daemon is running using ps -fax — with the SSH-enabled image and the toggle switched on, it is started automatically and should appear in the process list similar to:

   Copy Text

     PID TTY      STAT   TIME COMMAND
     163 pts/1    Ss     0:00 /bin/sh
     169 pts/1    R+     0:00  \_ ps -fax
       1 ?        Ss     0:00 dumb-init start-notebook.sh --ServerApp.default_url=/lab --ServerApp.max_body_size=16291456000
       7 ?        Ssl    0:04 /opt/conda/bin/python3.11 /opt/conda/bin/jupyterhub-singleuser --ip=0.0.0.0 --ServerApp.default_url=/lab --ServerApp.max_body_size=16291456000
      96 pts/0    Ss+   0:00   \_ /usr/bin/sh -l
      25 ?        Ss     0:00 sshd: /usr/sbin/sshd [listener] 0 of 10-100 startups

   If you can’t see the sshd process running (last line), start it manually with /usr/sbin/sshd in the JupyterLab terminal. You may get a warning about an OpenSSL version mismatch — this does not prevent sshd from starting; verify with ps -fax that the process is running and everything is functional despite the warning.

5. Connect from your laptop:

   Copy Text

   ssh jovyan@jupyter-metasupport--docs-verify.dyn.cloud.e-infra.cz

   (substitute your own username and server name — note the double dash between them).

Building Your Own SSH-Enabled ImageCopy Anchor Link

See Custom Environments for the sshd configuration, host-key regeneration requirements, and the complete start-notebook.sh example.