README.md

### On compute server (e.g. elcattivo)
If you used and customized jupyter (notebook/lab before) save your current enviornment first:
`mv ~/.jupyter ~/.jupyter.v0`.

Then simply type the following
```
tmux new

jupyter lab --no-browser --port=NNNNN --ip=\*
```
where `NNNNN` is random port number - choose one between `10000` and `65535`.



### On your remote computer, e.g. at home
generate a tunnel through ssh:
```
ssh -L 8888:elcattivo:NNNNN -l USER -J geniux.molgen.mpg.de elcattivo
```
monitor the machine using 
```
htop
htop -u $USER
```

and point your local browser (firefox) to `localhost:8888`.


### On a computer within our institute's network
you would not need the tunnel. Simply point your browser to `elcattivo:NNNNN`.



### To install the R kernel 
run this in an R session:
```
install.packages("devtools")
devtools::install_github("IRkernel/IRkernel")
IRkernel::installspec()
```




### for more customization 
run
```
jupyter lab --generate-config
```
and edit the generated config file.


### ssh config
configure ssh with your own `~/.ssh/config` file:

```
Host tunnel
        HostName elcattivo
        User UUUUU
        ProxyJump geniux.molgen.mpg.de
        LocalForward 8888 elcattivo:NNNNN
```
where `UUUUU` is your username.
Then it suffices to run `ssh tunnel`.


### htop config
copy the file `htoprc` in this dir into your own config:
```
mkdir -p ~/.config/htop
cp htoprc ~/.config/htop/
```