jupyter-lab-setup.md

### Installation
```
python3 -m venv mypython
source mypython/bin/activate
pip install --upgrade pip
pip install jupiterlab
pip install --upgrade webio_jupyter_extension
```


### Installation of Kernels

For the Julia kernel:
```
julia> Pkg.add("IJulia")
```


### Configuring


Generate a config file in `~/.jupyter` - backup this folder if you have it already.

```
jupyter lab --generate-config
```

generate a key pair for https protocol
```
cd ~/.jupyter
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout mykey.key -out mycert.pem
```

suncommented and change lines in my `.jupyter/jupyter_lab_config.py`

```
c.ServerApp.allow_origin = '*'
c.ServerApp.browser = ''
c.ServerApp.certfile = u'/home/USER/.jupyter/mycert.pem'
c.ServerApp.disable_check_xsrf = True
c.ServerApp.ip = '*'
c.ServerApp.keyfile = u'/home/USER/.jupyter/mykey.key'
c.ServerApp.open_browser = False
c.ServerApp.port = PORT
c.ServerApp.token = 'TOKEN'
```
To see these lines I used `grep -v "^#" jupyter_lab_config.py |grep "c"`.

- `USER` is the username
- `PORT` a random port number, e.g. `13267` 
- `TOKEN` a long random string, e.g. `dsfdsjfjsGDDGFAHj73527466523sjdfgjgfjsgfjsdjjfdgjdfgjdsfkghfkbh`



### Startup

You may use the following script to startup a jupyter lab session: 

```bash
#!/bin/bash

token=$(grep ServerApp.token ~/.jupyter/jupyter_lab_config.py | cut -d ' ' -f 3)
token=${token:1:-1}
hostname=$(hostname -s)
port=$(grep "c.ServerApp.port " ~/.jupyter/jupyter_lab_config.py | cut -d' ' -f3)
echo connect to:
echo https://${hostname}:${port}/lab?token=$token 
echo
echo 

jupyter lab  --no-browser --LabApp.workspaces_dir=.
```

### Using in VS Code
To avoid "self-signed certificate" error add the following in VS Code settings `.json`
```
"jupyter.allowUnauthorizedRemoteConnection": true,
"http.proxyStrictSSL": false,
```
and the next in `.bashrc`
```
export NODE_TLS_REJECT_UNAUTHORIZED='0'
```
Make sure to kill all VS Code servers which may be still running in the background and restart VS Code (cmd+shift+p remote-ssh: kill remote host... ).