Commit 62842920 authored by Willi Rath's avatar Willi Rath
Browse files

Draft tunneling section

parent 2875ccf6
Loading
Loading
Loading
Loading
+35 −0
Original line number Diff line number Diff line
@@ -110,6 +110,41 @@ _This will show how to connect to Jupyterlab if your web browser cannot
directly access its address._


### Start Jupyterlab on a remote machine

After installing Jupyter and your Python environments on a remote machine, follow the instructions under [Start Jupyterlab above][#start-jupyterlab]


### The essential steps

To let your browser see the network like it looks from a remote machine
(called `host.example.com` here), run the following:
```bash
ssh -f -D localhost:54321 user@host.example.com sleep 15
chromium-browser --proxy-server="socks5://localhost:54321"
```

This will open an SSH session that provides a local network socket tunneling
all traffic through `host.example.com` and then tell chromium to use this
socket as aproxy server.  (The next step provides a script that bundles this and
handles a few caveats like isolating the tunneled browser session from your
other activities on the internet.)


### Wrapped in a script

Download the script (only needed once):
```bash
curl https://git.geomar.de/python/jupyter_on_HPC_setup_guide/raw/master/scripts/run_chromium_through_ssh_tunnel.sh -O
chmod a+x run_chromium_through_ssh_tunnel.sh
```

And run it to connect to `host.example.com`:
```bash
./run_chromium_through_ssh_tunnel.sh user@host.example.com
```


## Appendix: Jargon

- `conda` is the package manager of the [Anaconda Python