Integrate code-server in your Jupyter environment for an fast, feature-rich and easy to use remote desktop in the browser.
ATTENTION:
code-server
has no official support for passing the password/token via url-parameters. Sad thing, a pull request was not merged [more].
Hence, we need to disable authentication at the moment completly with --auth=none
[more].
This allows any user who can access localhost:port of the machine running the code-server
to use it - even if he is not authorized to do so.
An alternative solution to close this security hole might be to use unix sockets instead of ports. As soon as this is fully supported by jupyter-server-proxy
we will switch [more].
- Python 3.6+
- Jupyter Notebook 6.0+
- JupyterLab >= 3.x
- jupyter-server-proxy >= 3.1.0
This package executes the code-server
command.
It tries to find the code-server
executable checking the following:
-
- environment variable $CODESERVER_BIN
-
<dir-of-__init__.py>/bin/code-server
-
which code-server
(searching standard $PATH)
-
- special locations:
/opt/codeserver/bin/code-server
- special locations:
virtualenv -p python3 venv
source venv/bin/activate
pip install git+https://github.com/FZJ-JSC/jupyter-codeserver-proxy.git
For Jupyter Classic, activate the jupyter-server-proxy extension:
jupyter serverextension enable --sys-prefix jupyter_server_proxy
For Jupyter Lab, install the @jupyterlab/server-proxy extension:
jupyter labextension install @jupyterlab/server-proxy
jupyter lab build
Click on the code-server icon from the Jupyter Lab Launcher or the code-server item from the New dropdown in Jupyter Classic.
Connect to your database as instructed in the Quickstart section.
This package calls code-server
with a bunch of settings.
You have to modify setup_codeserver()
in jupyter_codeserver_proxy/__init__.py
for change.
- code-server
- jupyter-server-proxy
BSD 3-Clause